Función ZwSetEvent (ntifs.h)

Artículo
08/07/2023

La rutina ZwSetEvent establece un objeto de evento en un estado Signaled e intenta satisfacer tantas esperas como sea posible.

Sintaxis

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

Parámetros

[in] EventHandle

Identificador de un objeto de evento.

[out, optional] PreviousState

Puntero opcional a una variable donde el estado anterior del objeto de evento se almacena en la salida.

Valor devuelto

ZwSetEvent devuelve STATUS_SUCCESS o un estado de error adecuado. Entre los posibles códigos de estado de error se incluyen los siguientes:

Código devuelto	Descripción
STATUS_ACCESS_DENIED	El autor de la llamada no tenía los privilegios necesarios para modificar el evento especificado por el parámetro EventHandle .
STATUS_INSUFFICIENT_RESOURCES	No se pudieron asignar los recursos requeridos por esta función.
STATUS_INVALID_HANDLE	El parámetro EventHandle proporcionado no era válido.

Comentarios

ZwSetEvent establece un objeto de evento en un estado Signaled e intenta satisfacer tantas esperas como sea posible.

Nota Si la llamada a la función ZwSetEvent se produce en modo de usuario, debe usar el nombre "NtSetEvent" en lugar de "ZwSetEvent".

En el caso de las llamadas desde controladores en modo kernel, las versiones NtXxx y ZwXxx de una rutina de Windows Native System Services pueden comportarse de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP
Plataforma de destino	Universal
Encabezado	ntifs.h (incluya Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL