Función ZwSetEvent (ntifs.h)

Artículo
12/21/2024

El ZwSetEvent rutina 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 códigos de estado de error posibles 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 recursos requeridos por esta función.
STATUS_INVALID_HANDLE	El parámetro proporcionado no era válido.

Observaciones

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 de 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 NtXxx y Zwversiones de Xxx de una rutina de Servicios del sistema nativo de Windows 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 de NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP
de la plataforma de destino de	Universal
encabezado de	ntifs.h (incluya Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	PASSIVE_LEVEL