Funzione ZwSetEvent (ntifs.h)

Articolo
12/21/2024

La routine ZwSetEvent imposta un oggetto evento su uno stato Signaled e tenta di soddisfare il maggior numero possibile di attese.

Sintassi

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

Parametri

[in] EventHandle

Handle per un oggetto evento.

[out, optional] PreviousState

Puntatore facoltativo a una variabile in cui lo stato precedente dell'oggetto evento viene archiviato nell'output.

Valore restituito

ZwSetEvent restituisce STATUS_SUCCESS o uno stato di errore appropriato. I codici di stato di errore possibili includono quanto segue:

Codice restituito	Descrizione
STATUS_ACCESS_DENIED	Il chiamante non dispone dei privilegi necessari per modificare l'evento specificato dal parametro EventHandle.
STATUS_INSUFFICIENT_RESOURCES	Impossibile allocare le risorse richieste da questa funzione.
STATUS_INVALID_HANDLE	Parametro EventHandle fornito non valido.

Osservazioni

ZwSetEvent imposta un oggetto evento su uno stato Signaled e tenta di soddisfare il maggior numero possibile di attese.

Nota Se la chiamata alla funzione ZwSetEvent si verifica in modalità utente, è consigliabile usare il nome "NtSetEvent" anziché "ZwSetEvent".

Per le chiamate da driver in modalità kernel, le NtXxx e ZwXxx versioni di una routine di Windows Native System Services possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Using Nt and Zw Versions of the Native System Services Routines.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP
piattaforma di destinazione	Universale
intestazione	ntifs.h (include Ntifs.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	PASSIVE_LEVEL