SetEvent-Funktion (synchapi.h)

Artikel
03/02/2024

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