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 上的 WinBase.h,Windows 7、Windows Server 2008 和 Windows Vista (包含 Windows.h)
程式庫
Kernel32.lib
DLL
Kernel32.dll

另請參閱

CancelIo

CancelIoEx

檔案管理功能

同步和非同步 I/O