取消所指定檔案呼叫執行緒所發出的所有擱置輸入和輸出 (I/O) 作業。 函式不會取消其他執行緒針對檔案控制代碼發出的 I/O 作業。
若要取消另一個執行緒的 I/O 作業，請使用 NtCancelIoFileEx 函 式。
注意
此函式是相當於 CancelIo Win32 函式的使用者模式。
語法
BOOL WINAPI NtCancelIoFile(
_In_ HANDLE hFile
);
參數
hFile [in]
檔案的控制碼。
函式會取消此檔案控制代碼的所有擱置 I/O 作業。
傳回
如果函式成功，則傳回非零的值。 已成功要求指定之檔案控制代碼之呼叫執行緒所發出之所有擱置 I/O 作業的取消作業。 執行緒可以使用 GetOverlappedResult 函式來判斷 I/O 作業本身何時完成。
如果函式失敗，傳回值為零， (0) 。 若要取得擴充的錯誤資訊，請呼叫 GetLastError 函 式。
備註
如果指定的檔案控制代碼有任何擱置的 I/O 作業正在進行中，而且由呼叫執行緒發出， 則 NtCancelIoFile 函式會取消它們。 NtCancelIoFile 只會取消控制碼上的未處理 I/O，它不會變更控制碼的狀態;這表示您無法依賴控制碼的狀態，因為您無法知道作業是否已順利完成或取消。
I/O 作業必須發出為重迭的 I/O。 如果不是，I/O 作業不會傳回以允許執行緒呼叫 NtCancelIoFile 函 式。 使用未以FILE_FLAG_OVERLAPPED開啟的檔案控制碼呼叫NtCancelIoFile函式不會執行任何動作。
所有已取消且錯誤 ERROR_OPERATION_ABORTED完成的 I/O 作業，I/O 作業的所有完成通知都會正常發生。
在Windows 8和Windows Server 2012中，下列技術支援此函式。
| 技術 | 支援 |
|---|---|
| 伺服器訊息區 (SMB) 3.0 通訊協定 |
Yes |
| SMB 3.0 透明容錯移轉 (TFO) |
Yes |
| 具有向外延展檔案共用的 SMB 3.0 (SO) |
Yes |
| 叢集共用磁片區檔案系統 (CsvFS) |
Yes |
| 彈性檔案系統 (ReFS) |
Yes |
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|