Функция 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

См. также раздел

OBJECT_INFORMATION_CLASS

PUBLIC_OBJECT_BASIC_INFORMATION

PUBLIC_OBJECT_TYPE_INFORMATION