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

另請參閱

CancelIo

CancelIoEx

檔案管理功能

同步和非同步 I/O