SetEvent, fonction (synchapi.h)

Article
03/04/2024

Définit l’objet d’événement spécifié à l’état signalé.

Syntaxe

BOOL SetEvent(
  [in] HANDLE hEvent
);

Paramètres

[in] hEvent

Handle de l’objet d’événement. La fonction CreateEvent ou OpenEvent retourne ce handle.

Le handle doit avoir le droit d’accès EVENT_MODIFY_STATE. Pour plus d’informations, consultez Synchronisation des droits d’accès et de sécurité des objets.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

L’état d’un objet d’événement de réinitialisation manuelle reste signalé jusqu’à ce qu’il soit explicitement défini sur l’état non signé par la fonction ResetEvent . Tout nombre de threads en attente, ou threads qui commencent par la suite des opérations d’attente pour l’objet d’événement spécifié en appelant l’une des fonctions d’attente, peuvent être libérés pendant que l’état de l’objet est signalé.

En revanche, l’état d’un objet d’événement de réinitialisation automatique reste signalé jusqu’à ce qu’un seul thread en attente soit libéré, auquel cas le système définit automatiquement l’état sur non signé. Si aucun thread n’attend, l’état de l’objet d’événement reste signalé.

La définition d’un événement déjà défini n’a aucun effet.

Les applications du Windows Store peuvent répondre aux événements nommés et aux sémaphores, comme décrit dans Comment répondre aux événements nommés et aux sémaphores.

Exemples

Pour obtenir un exemple qui utilise SetEvent, consultez Utilisation d’objets d’événements.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	synchapi.h (inclure Windows.h sur Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll