unregisterWait 函式 (winbase.h)

  • 發行項

取消 RegisterWaitForSingleObject 函式所發出的已註冊等候作業。

若要使用完成事件，請呼叫 UnregisterWaitEx 函 式。

語法

BOOL UnregisterWait(
  [in] HANDLE WaitHandle
);

參數

[in] WaitHandle

等候句柄。 RegisterWaitForSingleObject 函式會傳回此句柄。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

如果在呼叫 UnregisterWait 時，與定時器相關聯的任何回呼函式尚未完成， UnregisterWait 會取消註冊回呼函式的等候，並失敗並出現 ERROR_IO_PENDING 錯誤碼。 錯誤碼不表示函式失敗，而且不需要再次呼叫函式。 如果您的程式代碼只有在取消註冊作業失敗時，才需要設定錯誤碼，請改為呼叫 UnregisterWaitEx 。

若要編譯使用此函式的應用程式，請將 _WIN32_WINNT 定義為0x0500或更新版本。 如需詳細資訊，請參閱 使用 Windows 標頭。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

RegisterWaitForSingleObject

同步處理函式

執行緒共用

UnregisterWaitEx