NtQueryObject-Funktion (ntifs.h)
Die NtQueryObject-Routine stellt Informationen zu einem angegebenen 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, ü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 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 entsprechenden Fehler status zurück. Mögliche Fehler status Codes:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_ACCESS_DENIED | Es gab nicht genügend Berechtigungen, um diese Abfrage auszuführen. |
| STATUS_INVALID_HANDLE | Das angegebene Objekthandle ist ungültig. |
| STATUS_INFO_LENGTH_MISMATCH | Die Länge der Informationen reicht nicht aus, um die Daten zu enthalten. |
Hinweise
Wenn der Aufruf der NtQueryObject-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, wie 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 systemeigenen 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 | HwStorPortProhibitedDIs, PowerIrpDDis |