PFN_WSK_BIND コールバック関数 (wsk.h)

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

WskBind 関数は、ソケットをローカルトランスポートアドレスにバインドします。

構文

PFN_WSK_BIND PfnWskBind;

NTSTATUS PfnWskBind(
  [in]      PWSK_SOCKET Socket,
  [in]      PSOCKADDR LocalAddress,
            ULONG Flags,
  [in, out] PIRP Irp
)
{...}

パラメーター

[in] Socket

バインドされているソケットのソケットオブジェクトを指定する WSK_SOCKET 構造体へのポインター。

[in] LocalAddress

ソケットをバインドするローカルトランスポートアドレスを指定する構造体へのポインター。このポインターは、WSK アプリケーションがソケットの作成時に指定したアドレスファミリに対応する特定の SOCKADDR 構造体型へのポインターである必要があります。

Flags

このパラメーターは、システムで使用するために予約されています。 WSK アプリケーションでは、このパラメーターを 0 に設定する必要があります。

[in, out] Irp

WSK サブシステムがバインド操作を非同期的に完了するために使用する呼び出し元によって割り当てられた IRP へのポインター。 WSK 関数で IRP を使用する方法の詳細については、「 Winsock カーネル関数での IRP の使用」を参照してください。

戻り値

WskBind は 、次のいずれかの NTSTATUS コードを返します。

リターンコード	説明
STATUS_SUCCESS	ソケットがローカルトランスポートアドレスに正常にバインドされました。 IRP は成功状態で完了します。
STATUS_PENDING	WSK サブシステムはソケットをすぐにバインドできませんでした。 WSK サブシステムは、ソケットをローカルトランスポートアドレスにバインドした後、IRP を完了します。バインド操作の状態は、IRP の IoStatus.Status フィールドに返されます。
STATUS_FILE_FORCED_CLOSED	ソケットは機能しなくなりました。 IRP は失敗状態で完了します。 WSK アプリケーションは、できるだけ早くソケットを閉じるには、WskCloseSocket 関数を呼び出す必要があります。
その他の状態コード	エラーが発生しました。 IRP は失敗状態で完了します。

注釈

リッスンしているソケットの場合、 WskBind 関数を呼び出すと、指定されたローカルトランスポートアドレスで受信接続要求をリッスンするようにソケットが準備されます。 WSK アプリケーションでローカルワイルドカードアドレスが指定されている場合、ソケットはすべてのローカルトランスポートアドレスで受信接続要求をリッスンします。

データグラムソケットの場合、 WskBind 関数を呼び出すと、指定されたローカルトランスポートアドレスでデータグラムを送受信するソケットが準備されます。 WSK アプリケーションでローカルワイルドカードアドレスが指定されている場合、ソケットはすべてのローカルトランスポートアドレスでデータグラムを受信し、システムのルーティング情報によって決定される適切なローカルトランスポートアドレスからデータグラムを送信します。

接続指向ソケットの場合、 WskBind 関数を呼び出すと、指定したローカルトランスポートアドレスにソケットがバインドされます。 WskConnect 関数を呼び出す前に、WskBind を呼び出す必要があります。 WSK アプリケーションでローカルワイルドカードアドレスが指定されている場合、アプリケーションが WskConnect を呼び出してソケットをリモートトランスポートアドレスに接続するときに、ネットワークスタックによってソケットが適切なローカルトランスポートアドレスにバインドされます。このような状況では、ローカルトランスポートアドレスは、システムのルーティング情報によって決定されます。

ストリームソケットの場合、 WskBind 関数を呼び出すと、指定したローカルトランスポートアドレスにソケットがバインドされます。 WSK アプリケーションでローカルワイルドカードアドレスが指定されている場合、ネットワークスタックはソケットを使用可能なローカルトランスポートアドレスにバインドします。 WskListen または WskConnect 関数を呼び出す前に、WskBind を呼び出す必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	ユニバーサル
Header	wsk.h (Wsk.h を含む)
IRQL	<= DISPATCH_LEVEL