SIO_ADDRESS_LIST_QUERY

  • [アーティクル]

SIO_ADDRESS_LIST_QUERY ソケット I/O 制御操作を使用すると、WSK アプリケーションは、ソケットのアドレス ファミリのローカル トランスポート アドレスの現在のリストを照会できます。 このソケット I/O 制御操作は、すべてのソケットの種類に適用されます。

ソケットのアドレス ファミリのローカル トランスポート アドレスの現在の一覧を照会するために、WSK アプリケーションは次のパラメーターを使用して WskControlSocket 関数を呼び出します。

パラメーター 値

RequestType

WskIoctl

ControlCode

SIO_ADDRESS_LIST_QUERY

Level

0

InputSize

0

InputBuffer

NULL

OutputSize

OutputBuffer パラメーターによって指し示されている構造体の配列のバッファ サイズ (バイト単位)。

OutputBuffer

ローカル トランスポート アドレスの現在のリストを受け取るバッファーへのポインター。 バッファーのサイズは、OutputSize パラメーターで指定します。

OutputSizeReturned

OutputBuffer パラメーターが指すバッファーにコピーされるデータのバイト数を受け取る ULONG 型の変数へのポインター。

WSK アプリケーションは、ソケットのアドレス ファミリのローカル トランスポート アドレスの現在の一覧を照会する WskControlSocket 関数を呼び出すときに IRP へのポインターを指定しません。

WskControlSocket 関数の呼び出しが成功した場合、出力バッファーには、ソケットのアドレス ファミリのローカル トランスポート アドレスごとに SOCKADDR 構造体が続くSOCKET_ADDRESS_LIST 構造体が含まれます。

WskControlSocket 関数がSTATUS_BUFFER_OVERFLOWを返す場合、OutputSizeReturned パラメーターが指す変数には、ソケットのアドレス ファミリのローカル トランスポート アドレスの完全な一覧を格納するために必要な出力バッファー サイズ (バイト単位) が含まれます。

SIO_ADDRESS_LIST_CHANGE ソケット I/O 制御操作は、ソケットのアドレス ファミリのローカル トランスポート アドレスの一覧に変更があったときに WSK アプリケーションに通知します。

要件

バージョン

Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。

ヘッダー

 Ws2def.h (Wsk.h を含む)