ZwSetEvent-Funktion (ntifs.h)

Artikel
12/21/2024

Die ZwSetEvent Routine legt ein Ereignisobjekt auf einen Signaled-Zustand 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 ist.

Rückgabewert

ZwSetEvent gibt STATUS_SUCCESS oder einen geeigneten Fehlerstatus zurück. Mögliche Fehlerstatuscodes sind:

Rückgabecode	Beschreibung
STATUS_ACCESS_DENIED	Der Aufrufer verfügte nicht über die erforderlichen Berechtigungen, um das vom EventHandle Parameter angegebene Ereignis zu ändern.
STATUS_INSUFFICIENT_RESOURCES	Ressourcen, die von dieser Funktion benötigt werden, konnten nicht zugeordnet werden.
STATUS_INVALID_HANDLE	Der angegebene EventHandle Parameter war ungültig.

Bemerkungen

ZwSetEvent legt ein Ereignisobjekt auf einen Signaled-Zustand fest und versucht, so viele Wartezeiten wie möglich zu erfüllen.

Hinweis Wenn der Aufruf der funktion ZwSetEvent im Benutzermodus auftritt, 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, wie sie Eingabeparameter behandeln und interpretieren. Weitere Informationen zur Beziehung zwischen den NtXxx und ZwXxx- Versionen einer Routine finden Sie unter Using Nt and Zw Versions of the Native System Services Routines.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	PASSIVE_LEVEL