SetEvent-Funktion (synchapi.h)
Legt das angegebene Ereignisobjekt auf den signalierten Zustand fest.
Syntax
BOOL SetEvent(
[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 Sicherheit und Zugriffsrechte für Synchronisierungsobjekte.
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 für manuelles Zurücksetzen bleibt so lange signalisiert, bis es von der ResetEvent-Funktion explizit auf den nicht signalierten Zustand festgelegt wird. Eine beliebige Anzahl von wartenden Threads oder Threads, die anschließend Wartevorgänge für das angegebene Ereignisobjekt durch Aufrufen einer der Wartefunktionen beginnen, können freigegeben werden, während der Zustand des Objekts signalisiert wird.
Im Gegensatz dazu bleibt der Zustand eines Ereignisobjekts für das automatische Zurücksetzen signalisiert, bis ein einzelner wartenden Thread freigegeben wird. Zu diesem Zeitpunkt legt das System den Zustand automatisch auf nicht signalisiert fest. Wenn sich keine Threads in Warteposition befinden, verbleibt das Ereignisobjekt im signalisierten Zustand.
Das Festlegen eines ereignisses, das bereits festgelegt ist, hat keine Auswirkung.
Windows Store-Apps können auf benannte Ereignisse und Semaphore reagieren, wie unter Reagieren auf benannte Ereignisse und Semaphore beschrieben.
Beispiele
Ein Beispiel, das SetEvent verwendet, finden Sie unter Verwenden von Ereignisobjekten.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 (enthalten Windows.h unter Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |