ResetEvent-Funktion (synchapi.h)

Artikel
08/26/2023

Legt das angegebene Ereignisobjekt auf den nicht signalierten Zustand fest.

Syntax

BOOL ResetEvent(
  [in] HANDLE hEvent
);

Parameter

[in] hEvent

Ein Handle für das Ereignisobjekt. Die CreateEvent- oder OpenEvent-Funktion gibt dieses Handle zurück.

Das Handle muss über das zugriffsrecht EVENT_MODIFY_STATE verfügen. Weitere Informationen finden Sie unter Synchronisierungsobjektsicherheit und Zugriffsrechte.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Der Zustand eines Ereignisobjekts bleibt nicht signalisiert, bis es explizit auf die Signalisierung durch die SetEvent - oder PulseEvent-Funktion festgelegt ist. Dieser nicht signalgesteuerte Zustand blockiert die Ausführung aller Threads, die das Ereignisobjekt in einem Aufruf einer der Wartefunktionen angegeben haben.

Die ResetEvent-Funktion wird in erster Linie für manuelle Zurücksetzungsereignisobjekte verwendet, die explizit auf den nicht signalierten Zustand festgelegt werden müssen. Ereignisobjekte mit automatischem Zurücksetzen ändern sich automatisch von signalisiert in nicht signalisiert, nachdem ein einzelner wartenden Thread freigegeben wurde.

Das Zurücksetzen eines ereignisses, das bereits zurückgesetzt wurde, hat keine Auswirkung.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	synchapi.h (einschließlich Windows.h unter Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll