ZwQueryObject-Funktion (ntifs.h)

Artikel
07/11/2023

Die ZwQueryObject-Routine stellt Informationen zu einem bereitgestellten Objekt bereit.

Syntax

NTSYSAPI NTSTATUS ZwQueryObject(
  [in, optional]  HANDLE                   Handle,
  [in]            OBJECT_INFORMATION_CLASS ObjectInformationClass,
  [out, optional] PVOID                    ObjectInformation,
  [in]            ULONG                    ObjectInformationLength,
  [out, optional] PULONG                   ReturnLength
);

Parameter

[in, optional] Handle

Ein Handle für das Objekt, über das Informationen abgerufen werden sollen.

[in] ObjectInformationClass

Gibt einen OBJECT_INFORMATION_CLASS Wert an, der den Typ der im ObjectInformation-Puffer zurückgegebenen Informationen bestimmt.

[out, optional] ObjectInformation

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der die angeforderten Informationen empfängt.

[in] ObjectInformationLength

Gibt die Größe des ObjectInformation-Puffers in Bytes an.

[out, optional] ReturnLength

Ein Zeiger auf eine Variable, die die Größe der angeforderten Schlüsselinformationen in Bytes empfängt. Wenn ZwQueryObject STATUS_SUCCESS zurückgibt, enthält die Variable die Menge der zurückgegebenen Daten. Wenn ZwQueryObject STATUS_BUFFER_OVERFLOW oder STATUS_BUFFER_TOO_SMALL zurückgibt, können Sie den Wert der Variablen verwenden, um die erforderliche Puffergröße zu bestimmen.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_ACCESS_DENIED	Es gab nicht genügend Berechtigungen zum Ausführen dieser Abfrage.
STATUS_INVALID_HANDLE	Das angegebene Objekthandle ist ungültig.
STATUS_INFO_LENGTH_MISMATCH	Die Informationslänge reicht nicht aus, um die Daten aufzunehmen.

Hinweise

Wenn der Aufruf der ZwQueryObject-Funktion im Benutzermodus erfolgt, sollten Sie den Namen "NtQueryObject" anstelle von "ZwQueryObject" 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 2000.
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h, FltKernel.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Weitere Informationen

OBJECT_INFORMATION_CLASS

PUBLIC_OBJECT_BASIC_INFORMATION

PUBLIC_OBJECT_TYPE_INFORMATION

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen

Freigeben über