ZwSetEvent, fonction (ntifs.h)

Article
12/21/2024

La routine ZwSetEvent définit un objet é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 vers 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 de retour

ZwSetEvent retourne STATUS_SUCCESS ou un état d’erreur approprié. Les codes d’état d’erreur possibles sont les suivants :

Retourner le code	Description
STATUS_ACCESS_DENIED	L’appelant n’a pas les 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 événement à un état Signaled et tente de satisfaire autant d’attentes que possible.

Remarque 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 de 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 Using Nt and Zw Versions of the Native System Services Routines.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP
plateforme cible	Universel
d’en-tête	ntifs.h (include Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL