WSADuplicateSocketW 函式 (winsock2.h)

WSADuplicateSocket 函式會傳回WSAPROTOCOL_INFO結構，可用來建立共用套接字的新套接字描述項。 WSADuplicateSocket 函式無法在啟用 QOS 的套接字上使用。

語法

int WSAAPI WSADuplicateSocketW(
  [in]  SOCKET              s,
  [in]  DWORD               dwProcessId,
  [out] LPWSAPROTOCOL_INFOW lpProtocolInfo
);

參數

[in] s

識別本機套接字的描述項。

[in] dwProcessId

將使用重複套接字之目標進程的進程標識碼。

[out] lpProtocolInfo

用戶端所配置的緩衝區指標，足以包含 WSAPROTOCOL_INFO 結構。 服務提供者會將通訊協定資訊結構內容複製到這個緩衝區。

傳回值

如果沒有發生錯誤， WSADuplicateSocket 會傳回零。 否則，會傳回SOCKET_ERROR的值，並呼叫 WSAGetLastError 來擷取特定的錯誤碼。

備註

WSADuplicateSocket 函式可用來啟用進程之間的套接字共用。 來源進程會呼叫 WSADuplicateSocket 來取得特殊的 WSAPROTOCOL_INFO 結構。 它會使用一些進程間通訊 (IPC) 機制，將此結構的內容傳遞至目標進程，進而在 WSASocket 的呼叫中使用它來取得重複套接字的描述符。 特殊 WSAPROTOCOL_INFO 結構只能由目標進程使用一次。

套接字可以在指定進程中的線程之間共用，而不使用 WSADuplicateSocket 函式，因為套接字描述項在進程的所有線程中都是有效的。

下表說明建立和遞交共用套接字的一個可能案例。

參考共用套接字的描述項可以獨立用於 I/O。 不過，Windows Sockets 介面不會實作任何類型的訪問控制，因此它取決於協調其在共用套接字上作業的程式。 共用套接字通常用來擁有一個負責建立套接字和建立連線的程式，以及負責資訊交換的其他進程。

與套接字相關聯的所有狀態資訊會保留在所有描述項的通用狀態資訊，因為套接字描述項重複，而不是實際的套接字。 例如，使用一個描述項執行的 setockopt 作業後續會使用任何或所有描述項的 getsockopt 來顯示。 來源進程和目的地進程都應該將相同的旗標傳遞至其各自的 WSASocket 函式呼叫。 如果來源進程使用套接字函式來建立 套接字 ，目的地進程必須將 WSA_FLAG_OVERLAPPED 旗標傳遞至其 WSASocket 函數調用。 進程可以在重複的套接字上呼叫 closesocket ，而且描述項將會解除分配。 不過，基礎套接字會保持開啟狀態，直到最後剩餘的描述項呼叫 closesocket 為止。

共用套接字上的通知受限於 WSAAsyncSelect 和 WSAEventSelect 的一般條件約束。 使用任何共用描述項發出其中一個呼叫，會取消套接字的任何先前事件註冊，而不論使用哪一個描述元進行該註冊。 因此，共用套接字無法傳遞FD_READ事件來處理 A，並FD_WRITE事件來處理 B。對於需要這類緊密協調的情況，建議開發人員使用線程，而不是個別的進程。

Windows 8.1 和 Windows Server 2012 R2：Windows 8.1、Windows Server 2012 R2 和更新版本的 Windows 市集應用程式支援 WSADuplicateSocketW 函式。

規格需求

另請參閱

WSASocket

Winsock 函式

Winsock 參考