Condividi tramite


Funzione ZwSetEvent (ntifs.h)

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
Il parametro EventHandle fornito non è valido.

Commenti

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 versioni NtXxx e ZwXxx di una routine di Servizi di sistema nativi di Windows 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 .For more information about the Nt Xxx and Zw versions of the Native System Services Routines.

Requisiti

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

Vedi anche

IoCreateNotificationEvent

IoCreateSynchronizationEvent

KeClearEvent

KeResetEvent

KeSetEvent

KeWaitForSingleObject

Uso delle versioni Nt e Zw delle routine native di Servizi di sistema

ZwClose

ZwCreateEvent

ZwWaitForSingleObject