Функция ZwSetEvent (ntifs.h)

Статья
12/21/2024

Подпрограмма ZwSetEvent задает объект события в состояние Signaled и пытается удовлетворить максимальное количество ожиданий.

Синтаксис

NTSYSAPI NTSTATUS ZwSetEvent(
  [in]            HANDLE EventHandle,
  [out, optional] PLONG  PreviousState
);

Параметры

[in] EventHandle

Дескриптор объекта события.

[out, optional] PreviousState

Необязательный указатель на переменную, в которой предыдущее состояние объекта события хранится в выходных данных.

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

ZwSetEvent возвращает STATUS_SUCCESS или соответствующее состояние ошибки. Возможные коды состояния ошибок включают следующие:

Возвращаемый код	Описание
STATUS_ACCESS_DENIED	Вызывающий объект не имеет необходимых привилегий для изменения события, указанного параметром EventHandle.
STATUS_INSUFFICIENT_RESOURCES	Ресурсы, необходимые этой функции, не могут быть выделены.
STATUS_INVALID_HANDLE	Указанный параметр EventHandle был недопустимым.

Замечания

ZwSetEvent задает объект события в состояние Signaled и пытается удовлетворить максимально возможное количество ожиданий.

Примечание Если вызов функции ZwSetEvent происходит в пользовательском режиме, следует использовать имя "NtSetEvent" вместо "ZwSetEvent".

Для вызовов драйверов в режиме ядра NtXxx и ZwXxx версии подпрограммы Windows Native System Services могут вести себя по-разному в том, как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связи между NtXxx и ZwXxx версиями подпрограммы см. в разделе Using Nt and Zw Versions of the Native System Services Routines.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL