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 は 0 を返します。 それ以外の場合は、SOCKET_ERRORの値が返され、WSAGetLastError呼び出すことによって特定のエラー コードを取得できます。

備考

WSADuplicateSocket 関数 を使用して、プロセス間のソケット共有を有効にします。 ソース プロセス WSADuplicateSocket を呼び出して、特殊な WSAPROTOCOL_INFO 構造を取得します。 一部のプロセス間通信 (IPC) メカニズムを使用して、この構造体の内容をターゲット プロセスに渡します。このメカニズムは、WSASocket を する呼び出しでそれを使用して、重複したソケットの記述子を取得します。 特殊な WSAPROTOCOL_INFO 構造は、ターゲット プロセスで 1 回だけ使用できます。

ソケット記述子はプロセスのすべてのスレッドで有効であるため、WSADuplicateSocket 関数を使用せずに、特定のプロセス内のスレッド間でソケットを共有できます。

次の表に、共有ソケットを確立して引き渡すシナリオの 1 つを示します。

共有ソケットを参照する記述子は、I/O 用に個別に使用できます。 ただし、Windows ソケット インターフェイスはアクセス制御の種類を実装していないため、共有ソケットで操作を調整するプロセスに依存します。 通常、共有ソケットは、ソケットの作成と接続の確立を担当する 1 つのプロセスと、情報交換を担当する他のプロセスを持つ場合に使用されます。

ソケットに関連付けられているすべての状態情報は、ソケット記述子が実際のソケットではなく重複しているため、すべての記述子で共通に保持されます。 たとえば、1 つの記述子を使用して実行された setsockopt 操作は、その後、任意またはすべての記述子から getsockopt を使用して表示されます。 ソース プロセスと宛先プロセスの両方で、それぞれ WSASocket 関数呼び出しに同じフラグを渡す必要があります。 ソース プロセスが ソケット 関数を使用してソケットを作成する場合、宛先プロセスは、WSA_FLAG_OVERLAPPED フラグを WSASocket 関数呼び出し 渡す必要があります。 プロセスは、重複したソケット closesocket を呼び出すことができます。記述子の割り当てが解除されます。 ただし、基になるソケットは、最後の残りの記述子によって closesocket が呼び出されるまで 開いたままです。

共有ソケットでの通知は、WSAAsyncSelect と WSAEventSelect通常の制約の対象となります。 共有記述子のいずれかを使用してこれらの呼び出しのいずれかを発行すると、その登録に使用された記述子に関係なく、ソケットの以前のイベント登録が取り消されます。 したがって、共有ソケットは、A を処理するFD_READイベントを配信できず、イベントをFD_WRITEして B を処理することはできません。このような緊密な調整が必要な状況では、開発者は個別のプロセスではなくスレッドを使用することをお勧めします。

Windows 8.1 および windows Server 2012 R2: WSADuplicateSocketW 関数は、Windows 8.1、Windows Server 2012 R2 以降の Windows ストア アプリでサポートされています。

必要条件

関連項目

WSASocket の

Winsock Functions

Winsock リファレンス