CancelIo 函式

取消所指定檔案呼叫執行緒所發出的所有擱置輸入和輸出 (I/O) 作業。函式不會取消其他執行緒針對檔案控制代碼發出的 I/O 作業。

若要取消另一個執行緒的 I/O 作業，請使用 CancelIoEx 函 式。

語法

BOOL WINAPI CancelIo(
  _In_ HANDLE hFile
);

hFile [in]

檔案的控制碼。

函式會取消此檔案控制代碼的所有擱置 I/O 作業。

如果函式成功，則傳回非零的值。已成功要求指定之檔案控制代碼之呼叫執行緒所發出之所有擱置 I/O 作業的取消作業。執行緒可以使用 GetOverlappedResult 函式來判斷 I/O 作業本身何時完成。

如果函式失敗，傳回值為零， (0) 。若要取得擴充的錯誤資訊，請呼叫 GetLastError 函 式。

如果指定的檔案控制代碼有任何擱置的 I/O 作業正在進行中，而且由呼叫執行緒發出， CancelIo 函式會取消它們。 CancelIo 只會取消控制碼上的未處理 I/O，它不會變更控制碼的狀態;這表示您無法依賴控制碼的狀態，因為您無法知道作業是否已順利完成或取消。

I/O 作業必須發出為重迭的 I/O。如果不是，I/O 作業不會傳回以允許執行緒呼叫 CancelIo 函式。使用未以FILE_FLAG_OVERLAPPED開啟的檔案控制碼呼叫CancelIo函式不會執行任何動作。

所有已取消且錯誤 ERROR_OPERATION_ABORTED完成的 I/O 作業，I/O 作業的所有完成通知都會正常發生。

在Windows 8和Windows Server 2012中，下列技術支援此函式。

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
標頭	IoAPI.h (包括 Windows.h) ; Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP (上的 WinBase.h 包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll