Функция ResetEvent (synchapi.h)

Статья
08/26/2023

Задает для указанного объекта события состояние без знака.

Синтаксис

BOOL ResetEvent(
  [in] HANDLE hEvent
);

Параметры

[in] hEvent

Дескриптор объекта события. Функция CreateEvent или OpenEvent возвращает этот дескриптор.

Дескриптор должен иметь право доступа к EVENT_MODIFY_STATE. Дополнительные сведения см. в разделе Безопасность объектов синхронизации и права доступа.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Состояние объекта события остается без знака, пока ему не будет явно задано значение , заданное функцией SetEvent или PulseEvent . Это состояние без знака блокирует выполнение любых потоков, которые указали объект события в вызове одной из функций ожидания.

Функция ResetEvent используется в основном для объектов событий сброса вручную, которые должны быть явно заданы в состояние без знака. Объекты событий автоматического сброса автоматически изменяются с сигналов на неподписанные после освобождения одного потока ожидания.

Сброс события, которое уже сброшено, не оказывает никакого влияния.

Требования


Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	synchapi.h (включая Windows.h в Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Библиотека	Kernel32.lib
DLL	Kernel32.dll