CancelSynchronousIo 函式 (ioapiset.h)
將指定執行緒發出的暫止同步 I/O 作業標示為已取消。
語法
BOOL CancelSynchronousIo(
[in] HANDLE hThread
);
參數
[in] hThread
執行緒的控制碼。
傳回值
如果函式成功，則傳回非零的值。
如果函式失敗，傳回值為 0 (零) 。 若要取得擴充的錯誤資訊，請呼叫 GetLastError 函 式。
如果此函式找不到取消的要求，則傳回值為 0 (零) ，而 GetLastError 會 傳回ERROR_NOT_FOUND。
備註
呼叫端必須具有 THREAD_TERMINATE 存取權限。
如果指定的執行緒有任何擱置的 I/O 作業正在進行中， CancelSynchronousIo 函式會將它們標示為取消。 大部分的作業類型都可以立即取消;其他作業可以在實際取消之前繼續完成，並通知來電者。 CancelSynchronousIo函式不會等候所有取消的作業完成。 如需詳細資訊，請參閱 解除擱置的 I/O 作業。
取消的作業會以三種狀態之一完成;您必須檢查完成狀態，以判斷完成狀態。 這三種狀態為：
- 作業正常完成。 即使作業已取消，也會發生這種情況，因為取消要求可能尚未及時提交以取消作業。
- 已取消作業。 GetLastError函式會傳回ERROR_OPERATION_ABORTED。
- 作業失敗，發生另一個錯誤。 GetLastError 函式會傳回相關的錯誤碼。
| 技術 | 支援 |
|---|---|
| 伺服器訊息區 (SMB) 3.0 通訊協定 | 是 |
| SMB 3.0 透明容錯移轉 (TFO) | 是 |
| 具有向外延展檔案共用的 SMB 3.0 (SO) | 是 |
| 叢集共用磁片區檔案系統 (CsvFS) | 是 |
| 彈性檔案系統 (ReFS) | 是 |
規格需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | ioapiset.h (包含 Windows.h) |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |