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 |