WSACancelAsyncRequest

WSACancelAsyncRequest 関数 (winsock.h) は、未完了の非同期操作をキャンセルする。

WSACancelAsyncRequest hAsyncTaskHandle

hAsyncTaskHandle : [intptr] キャンセルする非同期操作を指定するハンドル。

(プラグイン / モジュール : ws2_32.dll)

解説

WSACancelAsyncRequest 関数 (winsock.h) は、未完了の非同期操作をキャンセルする。

[戻り値]
WSACancelAsyncRequest が返す値は、操作が正常にキャンセルされた場合はゼロである。そうでない場合は
SOCKET_ERROR を返し、WSAGetLastError を呼び出すことで特定のエラー番号を取得できる。
（以下省略）

[備考]
WSACancelAsyncRequest 関数は、WSAAsyncGetHostByName などの WSAAsyncGetXByY
関数のいずれかによって開始された非同期操作をキャンセルするために使用される。キャンセル対象の操作は hAsyncTaskHandle
パラメータで識別され、これには開始した WSAAsyncGetXByY 関数が返した非同期タスクハンドルを設定する。既存の非同期
WSAAsyncGetXByY 操作のキャンセル試行は、2 つの理由により WSAEALREADY エラーコードで失敗することがある。第
1 に、元の操作が既に完了しアプリケーションが結果のメッセージを処理し終えている場合。第 2
に、元の操作は既に完了したが結果のメッセージがまだアプリケーションウィンドウのキューに残っている場合。

情報