CancelThreadpoolIo 関数 (threadpoolapiset.h)

StartThreadpoolIo 関数からの通知を取り消します。

構文

void CancelThreadpoolIo(
  [in, out] PTP_IO pio
);

[in, out] pio

I/O 完了オブジェクトを定義する TP_IO 構造体へのポインター。 CreateThreadpoolIo 関数は、このポインターを返します。

なし

メモリリークを防ぐには、次のいずれかのシナリオで CancelThreadpoolIo 関数を呼び出す必要があります。

重複した (非同期) I/O 操作が失敗する (つまり、非同期 I/O 関数呼び出しは、ERROR_IO_PENDING以外のエラーコードでエラーを返します)。
非同期 I/O 操作は成功するとすぐに返され、I/O 完了オブジェクトに関連付けられているファイルハンドルには通知モードがFILE_SKIP_COMPLETION_PORT_ON_SUCCESS。ファイルハンドルは I/O 完了ポートに通知せず、関連付けられている I/O コールバック関数は呼び出されません。

この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNTを 0x0600 以上として定義します。

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	threadpoolapiset.h (Windows 7、Windows Server 2008 Windows Server 2008 R2 の場合は Windows.h を含む)
Library	Kernel32.lib
[DLL]	Kernel32.dll