PFN_WSK_ABORT_EVENT コールバック関数 (wsk.h)
WskAbortEvent イベント コールバック関数は、条件付き受け入れモードが有効になっているリッスン ソケットでの受信接続要求が削除されたことを WSK アプリケーションに通知します。
構文
PFN_WSK_ABORT_EVENT PfnWskAbortEvent;
NTSTATUS PfnWskAbortEvent(
[in, optional] PVOID SocketContext,
[in] PWSK_INSPECT_ID InspectID
)
{...}
パラメーター
[in, optional] SocketContext
受信接続要求を受信したリッスン ソケットのソケット コンテキストへのポインター。 WSK アプリケーションは、WskSocket 関数を呼び出してリッスン ソケットを作成するときに、このポインターを WSK サブシステムに提供しました。
[in] InspectID
WSK_INSPECT_ID 構造体へのポインター。 構造体の内容は、削除された受信接続要求を識別します。
戻り値
WSK アプリケーションの WskAbortEvent イベント コールバック関数は、常にSTATUS_SUCCESSを返す必要があります。
備考
WSK サブシステムは、WSK アプリケーションの WskAbortEvent イベント コールバック関数を呼び出します。これは、次の条件に該当する場合のみです。
- WSK アプリケーションは、条件付き受け入れモードが有効になっているリッスン ソケットを作成しました。
- 受信接続要求がリッスン ソケットで受信され、WSK サブシステムが WSK アプリケーションの WskInspectEvent イベント コールバック関数を呼び出しました。
- WSK アプリケーションは、WskInspectPend 返すか、受信接続要求のイベント コールバック関数 WskAbortEvent から WskInspectAccept を しました。
- 着信接続要求は、完全に確立される前にローカルまたはリモートで削除されています。
中止された受信接続要求で WSK アプリケーションが WskInspectComplete 関数を呼び出した場合、Action パラメーターに WskInspectAccept 指定されている場合でも、接続は確立されません。
WSK アプリケーションでは、SO_CONDITIONAL_ACCEPT ソケット オプションを有効にすることで、リッスン ソケットで条件付き受け入れモードを有効にすることができます。 受信接続を条件付きで受け入れる方法の詳細については、「受信接続のリッスンと受け入れ」を参照してください。
WSK サブシステムは、WSK アプリケーションの WskAbortEvent イベント コールバック関数を IRQL <= DISPATCH_LEVEL で呼び出します。
WSK アプリケーションの WskAbortEvent イベント コールバック関数は、WSK 完了またはイベント コールバック関数のコンテキストで他の WSK 要求の完了を待つ必要はありません。 コールバックは他の WSK 要求を開始できますが (DISPATCH_LEVELで時間がかかりすぎないことを前提とします)、IRQL = PASSIVE_LEVEL でコールバックが呼び出された場合でも、その完了を待つ必要はありません。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | wsk.h (Wsk.h を含む) |
| IRQL | <= DISPATCH_LEVEL |
関連項目
WskControlSocket の
WskInspectComplete の
WskInspectEvent の
WskSocket の