次の方法で共有

WSK_INSPECT_ID構造体 (wsk.h)

  • [アーティクル]

WSK_INSPECT_ID構造体は、リッスン ソケットでの受信接続要求の識別子を指定します。

構文

typedef struct _WSK_INSPECT_ID {
  ULONG_PTR Key;
  ULONG     SerialNumber;
} WSK_INSPECT_ID, *PWSK_INSPECT_ID;

メンバーズ

Key

受信接続要求に割り当てられるキー。

SerialNumber

受信接続要求に割り当てられるシリアル番号。

備考

WSK サブシステムは、条件付き受け入れモードが有効になっているリッスン ソケットに着信接続要求が到着するたびに、WSK アプリケーションの WskInspectEvent イベント コールバック関数にWSK_INSPECT_ID構造体へのポインターを渡します。 WSK_INSPECT_ID構造体の内容は、受信接続要求を一意に識別します。

WSK アプリケーションが、WskInspectEvent イベント コールバック関数の呼び出しから WskInspectPend を返す場合、アプリケーションはまず、WSK サブシステムによって提供されるWSK_INSPECT_ID構造体の コンテンツを独自のWSK_INSPECT_ID構造体にコピーする必要があります。 その後、WSK アプリケーションは、検査が完了したときに、そのWSK_INSPECT_ID構造体へのポインターを WskInspectComplete 関数に渡します。

検査操作が保留中の間に受信接続要求がリモート システムによって削除された場合、WSK サブシステムは、WSK アプリケーションの WskAbortEvent イベント コールバック関数を、ドロップされた要求を識別するWSK_INSPECT_ID構造体へのポインターを使用して呼び出します。 WSK アプリケーションは、このWSK_INSPECT_ID構造の内容を使用して、着信接続要求の検査を終了する必要があるかどうかを判断します。 WSK アプリケーションは、WSK_INSPECT_ID構造体の内容を比較して一致を確認する必要があります。 構造体メンバーの実際の値は関係ありません。

WSK アプリケーションでは、SO_CONDITIONAL_ACCEPT ソケット オプションを有効にすることで、リッスン ソケットで条件付き受け入れモードを有効にすることができます。 受信接続を条件付きで受け入れる方法の詳細については、「受信接続のリッスンと受け入れ」を参照してください。

必要条件

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

関連項目

SO_CONDITIONAL_ACCEPT

WskAbortEvent の

WskInspectComplete の

WskInspectEvent の