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_INSPECT_ID構造体へのポインターを使用して 、WSK アプリケーションの WskAbortEvent イベント コールバック関数を呼び出します。 WSK アプリケーションは、このWSK_INSPECT_ID構造体の内容を使用して、受信接続要求を終了する必要がある検査を決定します。 WSK アプリケーションは、WSK_INSPECT_ID構造体の内容を一致のチェックと比較する必要があります。 構造体メンバーの実際の値は関係ありません。

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

要件

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

こちらもご覧ください

SO_CONDITIONAL_ACCEPT

WskAbortEvent

WskInspectComplete

WskInspectEvent