Функция UnregisterWait (winbase.h)

Статья
03/03/2024

Отменяет зарегистрированную операцию ожидания, выданную функцией 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

См. также

RegisterWaitForSingleObject

Функции синхронизации

Группировка потоков в пул

Отмена регистрацииWaitEx

Share via