Fonction ResetEvent (synchapi.h)

Article
08/26/2023

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