Функция 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 |
Header | winbase.h (включая Windows.h) |
Библиотека | Kernel32.lib |
DLL | Kernel32.dll |