Fonction ZwSetEvent (ntifs.h)

Article
02/29/2024

La routine ZwSetEvent définit un objet d’événement à un état Signaled et tente de satisfaire autant d’attentes que possible.

Syntaxe

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

Paramètres

[in] EventHandle

Handle d’un objet d’événement.

[out, optional] PreviousState

Pointeur facultatif vers une variable où l’état précédent de l’objet d’événement est stocké sur la sortie.

Valeur retournée

ZwSetEvent retourne STATUS_SUCCESS ou une status d’erreur appropriée. Les codes de status d’erreur possibles incluent les éléments suivants :

Code de retour	Description
STATUS_ACCESS_DENIED	L’appelant ne disposait pas des privilèges requis pour modifier l’événement spécifié par le paramètre EventHandle .
STATUS_INSUFFICIENT_RESOURCES	Les ressources requises par cette fonction n’ont pas pu être allouées.
STATUS_INVALID_HANDLE	Le paramètre EventHandle fourni n’était pas valide.

Remarques

ZwSetEvent définit un objet d’événement à un état Signaled et tente de satisfaire autant d’attentes que possible.

Note Si l’appel à la fonction ZwSetEvent se produit en mode utilisateur, vous devez utiliser le nom « NtSetEvent » au lieu de « ZwSetEvent ».

Pour les appels à partir de pilotes en mode noyau, les versions NtXxx et ZwXxx d’une routine Windows Native System Services peuvent se comporter différemment dans la façon dont elles gèrent et interprètent les paramètres d’entrée. Pour plus d’informations sur la relation entre les versions NtXxx et ZwXxx d’une routine, consultez Utilisation des versions Nt et Zw des routines des services système natifs.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP
Plateforme cible	Universal
En-tête	ntifs.h (inclure Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL