GetAcceptExSockaddrs 関数 (mswsock.h)
GetAcceptExSockaddrs 関数は、AcceptEx 関数の呼び出しから取得したデータを解析し、ローカル アドレスとリモート アドレスを sockaddr 構造体に渡します。
構文
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 関数を使用する必要があります。
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 |