GetAcceptExSockaddrs 関数 (mswsock.h)

[アーティクル]
03/15/2023

GetAcceptExSockaddrs 関数は、AcceptEx 関数の呼び出しから取得したデータを解析し、ローカルアドレスとリモートアドレスを sockaddr 構造体に渡します。

メモこの関数は、Windows ソケット仕様に対する Microsoft 固有の拡張機能です。

構文

void GetAcceptExSockaddrs(
  [in]  PVOID    lpOutputBuffer,
  [in]  DWORD    dwReceiveDataLength,
  [in]  DWORD    dwLocalAddressLength,
  [in]  DWORD    dwRemoteAddressLength,
  [out] sockaddr **LocalSockaddr,
  [out] LPINT    LocalSockaddrLength,
  [out] sockaddr **RemoteSockaddr,
  [out] LPINT    RemoteSockaddrLength
);

パラメーター

[in] lpOutputBuffer

AcceptEx 呼び出しの結果として接続で送信されるデータの最初のブロックを受け取るバッファーへのポインター。 AcceptEx 関数に渡されたのと同じ lpOutputBuffer パラメーターである必要があります。

[in] dwReceiveDataLength

最初のデータの受信に使用されるバッファー内のバイト数。この値は、AcceptEx 関数に渡された dwReceiveDataLength パラメーターと等しい必要があります。

[in] dwLocalAddressLength

ローカルアドレス情報用に予約されているバイト数。この値は、AcceptEx 関数に渡された dwLocalAddressLength パラメーターと等しい必要があります。

[in] dwRemoteAddressLength

リモートアドレス情報用に予約されたバイト数。この値は、AcceptEx 関数に渡された dwRemoteAddressLength パラメーターと等しい必要があります。

[out] LocalSockaddr

接続のローカルアドレスを受け取る sockaddr 構造体へのポインター ( getsockname 関数によって返されるのと同じ情報)。このパラメーターを指定する必要があります。

[out] LocalSockaddrLength

ローカルアドレスのサイズ (バイト単位)。このパラメーターを指定する必要があります。

[out] RemoteSockaddr

接続のリモートアドレスを受け取る sockaddr 構造体へのポインター ( getpeername 関数によって返されるのと同じ情報)。このパラメーターを指定する必要があります。

[out] RemoteSockaddrLength

ローカルアドレスのサイズ (バイト単位)。このパラメーターを指定する必要があります。

戻り値

なし

解説

GetAcceptExSockaddrs 関数は AcceptEx 関数と共に排他的に使用され、ソケットが受け取る最初のデータをローカルアドレスとリモートアドレスに解析します。 AcceptEx 関数は、ローカルおよびリモートのアドレス情報を内部形式で返します。ローカルまたはリモートアドレスを含む sockaddr 構造体が必要な場合、アプリケーション開発者は GetAcceptExSockaddrs 関数を使用する必要があります。

メモgetAcceptExSockaddrs 関数の関数ポインターは、実行時に、SIO_GET_EXTENSION_FUNCTION_POINTERオペコードを指定して WSAIoctl 関数を呼び出すことによって取得する必要があります。 WSAIoctl 関数に渡される入力バッファーには、getAcceptExSockaddrs 拡張関数を識別する値を持つグローバル一意識別子 (GUID) WSAID_GETACCEPTEXSOCKADDRSが含まれている必要があります。成功すると、 WSAIoctl 関数によって返される出力には 、GetAcceptExSockaddrs 関数へのポインターが含まれます。 WSAID_GETACCEPTEXSOCKADDRS GUID は、Mswsock.h ヘッダーファイルで定義されています。

Windows Phone 8: この関数は、Windows Phone 8 以降の Windows Phone ストアアプリでサポートされています。

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

要件

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