Fonction ResetEvent (synchapi.h)
Définit l’objet d’événement spécifié à l’état non signé.
Syntaxe
BOOL ResetEvent(
[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 reste non signé jusqu’à ce qu’il soit explicitement défini sur signalé par la fonction SetEvent ou PulseEvent . Cet état non signé bloque l’exécution de tous les threads qui ont spécifié l’objet d’événement dans un appel à l’une des fonctions d’attente.
La fonction ResetEvent est principalement utilisée pour les objets d’événement de réinitialisation manuelle, qui doivent être définis explicitement à l’état non signé. Les objets d’événement de réinitialisation automatique passent automatiquement de signalés à non signés après la libération d’un seul thread en attente.
La réinitialisation d’un événement qui est déjà réinitialisé n’a aucun effet.
Configuration requise
| 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 |