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中,下列技術支援此函式。
技術 | 支援 |
---|---|
伺服器訊息區 (SMB) 3.0 通訊協定 |
Yes |
SMB 3.0 透明容錯移轉 (TFO) |
Yes |
具有向外延展檔案共用的 SMB 3.0 (SO) |
Yes |
叢集共用磁片區檔案系統 (CsvFS) |
Yes |
彈性檔案系統 (ReFS) |
Yes |
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows XP [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 |
Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
標頭 |
|
程式庫 |
|
DLL |
|