ZwSetEvent-Funktion (ntifs.h)

Artikel
02/26/2024

Die ZwSetEvent-Routine legt ein Ereignisobjekt auf den Signalzustand fest und versucht, so viele Wartezeiten wie möglich zu erfüllen.

Syntax

NTSYSAPI NTSTATUS ZwSetEvent(
  [in]            HANDLE EventHandle,
  [out, optional] PLONG  PreviousState
);

Parameter

[in] EventHandle

Ein Handle für ein Ereignisobjekt.

[out, optional] PreviousState

Ein optionaler Zeiger auf eine Variable, in der der vorherige Zustand des Ereignisobjekts in der Ausgabe gespeichert wird.

Rückgabewert

ZwSetEvent gibt STATUS_SUCCESS oder einen entsprechenden Fehler status zurück. Mögliche Fehler status Codes sind:

Rückgabecode	Beschreibung
STATUS_ACCESS_DENIED	Der Aufrufer verfügte nicht über die erforderlichen Berechtigungen zum Ändern des durch den EventHandle-Parameter angegebenen Ereignisses.
STATUS_INSUFFICIENT_RESOURCES	Ressourcen, die für diese Funktion erforderlich sind, konnten nicht zugeordnet werden.
STATUS_INVALID_HANDLE	Der angegebene EventHandle-Parameter war ungültig.

Hinweise

ZwSetEvent legt ein Ereignisobjekt auf den Signalzustand fest und versucht, so viele Wartezeiten wie möglich zu erfüllen.

Hinweis Wenn der Aufruf der ZwSetEvent-Funktion im Benutzermodus erfolgt, sollten Sie den Namen "NtSetEvent" anstelle von "ZwSetEvent" verwenden.

Bei Aufrufen von Kernelmodustreibern können sich die NtXxx - und ZwXxx-Versionen einer Windows Native System Services-Routine anders verhalten, da sie Eingabeparameter verarbeiten und interpretieren. Weitere Informationen zur Beziehung zwischen den Nt Xxx- und ZwXxx-Versionen einer Routine finden Sie unter Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL