WSK_TRANSPORT_LIST_QUERY
WSK アプリケーションは、WSK_TRANSPORT_LIST_QUERY クライアント制御操作を使用して、新しいソケットの作成時に指定できる使用可能なネットワーク トランスポートの一覧を取得します。
使用可能なネットワーク トランスポートの一覧を取得するために、WSK アプリケーションは、以下のパラメーターを指定して WskControlClient 関数を呼び出します。
パラメーター | 値 |
---|---|
ControlCode |
WSK_TRANSPORT_LIST_QUERY |
InputSize |
0 |
InputBuffer |
NULL |
OutputSize |
OutputBuffer パラメーターによって指し示されている構造体の配列のサイズ (バイト単位) |
OutputBuffer |
使用可能なネットワーク トランスポートの一覧を受け取る WSK_TRANSPORT 構造体の配列へのポインター |
OutputSizeReturned |
OutputBuffer パラメーターによって指し示される構造体の配列にコピーされるデータのバイト数を受け取る、SIZE_T 型の変数へのポインター |
Irp |
NULL |
WSK アプリケーションは、OutputSize パラメーターに 0 を指定し、OutputBuffer パラメーターに NULL を指定して、使用可能なネットワーク トランスポートの完全な一覧を格納するために必要な WSK_TRANSPORT 構造体の配列のサイズをバイト単位で決定できます。 このような状況では、WskControlClient 関数の呼び出しは STATUS_BUFFER_OVERFLOW を返し、OutputSizeReturned パラメーターによって指し示される変数には必要なバッファー サイズが含まれています。 その後、アプリケーションは、使用可能なネットワーク トランスポートの完全な一覧を格納するために十分な大きさのバッファーを割り当てることができ、前の表に示されているパラメーターを指定して、2 度目の WskControlClient 関数呼び出しを行うことができます。
Irp パラメーターは、このクライアント制御操作では NULL である必要があります。
要件
バージョン |
Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
ヘッダー |
Wsk.h (Wsk.h のインクルード) |