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