Функция NtQueryObject (ntifs.h)
Подпрограмма NtQueryObject предоставляет сведения о предоставленном объекте.
Синтаксис
__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
Дескриптор объекта для получения сведений.
[in] ObjectInformationClass
Задает значение OBJECT_INFORMATION_CLASS , определяющее тип сведений, возвращаемых в буфере ObjectInformation .
[out, optional] ObjectInformation
Указатель на буфер, выделенный вызывающим объектом, который получает запрошенные сведения.
[in] ObjectInformationLength
Задает размер буфера ObjectInformation в байтах.
[out, optional] ReturnLength
Указатель на переменную, которая получает размер запрошенных сведений о ключе в байтах. Если NtQueryObject возвращает STATUS_SUCCESS, переменная содержит объем возвращаемых данных. Если NtQueryObject возвращает STATUS_BUFFER_OVERFLOW или STATUS_BUFFER_TOO_SMALL, можно использовать значение переменной для определения требуемого размера буфера.
Возвращаемое значение
NtQueryObject возвращает STATUS_SUCCESS или соответствующее состояние ошибки. Возможные коды состояния ошибок:
| Код возврата | Описание |
|---|---|
| STATUS_ACCESS_DENIED | Для выполнения этого запроса недостаточно разрешений. |
| STATUS_INVALID_HANDLE | Предоставленный дескриптор объекта недопустим. |
| STATUS_INFO_LENGTH_MISMATCH | Длина сведений недостаточную для хранения данных. |
Комментарии
Если вызов функции NtQueryObject происходит в пользовательском режиме, следует использовать имя NtQueryObject вместо ZwQueryObject.
Для вызовов из драйверов режима ядра версии NtXxx и ZwXxx подпрограммы собственных системных служб Windows могут вести себя по-разному, так как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связи между версиями процедуры NtXxx и ZwXxx см. в разделе Использование версий Nt и Zw для процедур собственных системных служб.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000. |
| Целевая платформа | Универсальное |
| Верхняя часть | ntifs.h (включая Ntifs.h, FltKernel.h) |
| Библиотека | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Правила соответствия DDI | HwStorPortProhibitedDIs, PowerIrpDDis |