NtQueryObject-Funktion (ntifs.h)
Die NtQueryObject Routine stellt Informationen zu einem bereitgestellten Objekt bereit.
__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
);
[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.
NtQueryObject- gibt STATUS_SUCCESS oder einen geeigneten Fehlerstatus zurück. Mögliche Fehlerstatuscodes sind:
Rückgabecode | Beschreibung |
---|---|
STATUS_ACCESS_DENIED | Für diese Abfrage waren unzureichende Berechtigungen vorhanden. |
STATUS_INVALID_HANDLE | Das angegebene Objekthandle ist ungültig. |
STATUS_INFO_LENGTH_MISMATCH | Die Länge der Informationen reicht nicht aus, um die Daten aufzunehmen. |
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.
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Windows 2000. |
Zielplattform- | Universal |
Header- | ntifs.h (einschließlich Ntifs.h, FltKernel.h) |
Library | NtosKrnl.lib |
DLL- | NtosKrnl.exe |
IRQL- | PASSIVE_LEVEL |
DDI-Complianceregeln | HwStorPortProhibitedDIs, PowerIrpDDis |