Share via

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)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

CloseThreadpoolIo

CreateThreadpoolIo

StartThreadpoolIo

線程集區

WaitForThreadpoolIoCallbacks