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

[アーティクル]
02/07/2025

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

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

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
ターゲットプラットフォームの	万国
ヘッダー	wsk.h (Wsk.h を含む)
IRQL	<= DISPATCH_LEVEL

次の方法で共有

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

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース