SetEvent, fonction (synchapi.h)
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 |