WSADuplicateSocketA 関数 (winsock2.h)

[アーティクル]
08/27/2023

WSADuplicateSocket 関数は、共有ソケットの新しいソケット記述子を作成するために使用できるWSAPROTOCOL_INFO構造体を返します。 WSADuplicateSocket 関数は、QOS 対応ソケットでは使用できません。

構文

int WSAAPI WSADuplicateSocketA(
  [in]  SOCKET              s,
  [in]  DWORD               dwProcessId,
  [out] LPWSAPROTOCOL_INFOA lpProtocolInfo
);

パラメーター

[in] s

ローカルソケットを識別する記述子。

[in] dwProcessId

重複したソケットが使用されるターゲットプロセスのプロセス識別子。

[out] lpProtocolInfo

クライアントによって割り当てられたバッファーへのポインター。これは、WSAPROTOCOL_INFO 構造体を格納するのに十分な大きさです。サービスプロバイダーは、プロトコル情報構造体の内容をこのバッファーにコピーします。

戻り値

エラーが発生しない場合、 WSADuplicateSocket は 0 を返します。それ以外の場合は、SOCKET_ERRORの値が返され、 WSAGetLastError を呼び出すことによって特定のエラーコードを取得できます。

エラーコード	意味
WSANOTINITIALIZED	この関数を使用する前に、WSAStartup 呼び出しが正常に行われる必要があります。
WSAENETDOWN	ネットワークサブシステムが失敗しました。
WSAEINVAL	指定されたパラメーターのいずれかが無効であることを示します。
WSAEINPROGRESS	ブロックしている Windows ソケット 1.1 呼び出しが進行中であるか、サービスプロバイダーがコールバック関数を処理しています。
WSAEMFILE	これ以上使用できるソケット記述子がありません。
WSAENOBUFS	バッファーに空き領域がありません。ソケットを作成できません。
WSAENOTSOCK	記述子はソケットではありません。
WSAEFAULT	lpProtocolInfo パラメーターは、ユーザーアドレス空間の有効な部分ではありません。

解説

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

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

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

Source process (依存元プロセス)	IPC	Destination process (依存先プロセス)
1) WSASocket、 WSAConnect
2) 要求ターゲットプロセス識別子	==>
		3) プロセス識別子要求を受信して応答する
4) プロセス識別子を受信する	<==
5) WSADuplicateSocket を呼び出して特別な WSAPROTOCOL_INFO 構造を取得する
6) WSAPROTOCOL_INFO 構造をターゲットに送信する
	==>	7) 受信 WSAPROTOCOL_INFO 構造
		8) WSASocket を呼び出して、共有ソケット記述子を作成します。
		9) データ交換に共有ソケットを使用する
10) closesocket	<==

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

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

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

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

注意

winsock2.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして WSADuplicateSocket を定義します。エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件


サポートされている最小のクライアント	Windows 8.1、 Windows Vista [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	winsock2.h
Library	Ws2_32.lib
[DLL]	Ws2_32.dll

次の方法で共有

WSADuplicateSocketA 関数 (winsock2.h)

構文

パラメーター

戻り値

解説

要件

関連項目

フィードバック

その他のリソース