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
| 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 |