ResetEvent-Funktion (synchapi.h)

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

Siehe auch

CreateEvent

Ereignisobjekte

OpenEvent

PulseEvent

SetEvent

Synchronisierungsfunktionen