NtQueryObject-Funktion (ntifs.h)

Die NtQueryObject Routine stellt Informationen zu einem bereitgestellten Objekt bereit.

Syntax

__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryObject(
  [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 zum Abrufen von Informationen.

[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 Byte an.

[out, optional] ReturnLength

Ein Zeiger auf eine Variable, die die Größe der angeforderten Schlüsselinformationen in Byte empfängt. Wenn NtQueryObject STATUS_SUCCESS zurückgibt, enthält die Variable die zurückgegebene Datenmenge. Wenn NtQueryObject 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

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

Bemerkungen

Wenn der Aufruf der NtQueryObject--Funktion im Benutzermodus auftritt, 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, 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

Siehe auch

OBJECT_INFORMATION_CLASS

PUBLIC_OBJECT_BASIC_INFORMATION

PUBLIC_OBJECT_TYPE_INFORMATION