Функция ZwQueryObject (ntifs.h)

Статья
12/21/2024

Подпрограмма ZwQueryObject предоставляет сведения о предоставленном объекте.

Синтаксис

NTSYSAPI NTSTATUS ZwQueryObject(
  [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

Указатель на переменную, которая получает размер в байтах запрошенных сведений о ключе. Если ZwQueryObject возвращает STATUS_SUCCESS, переменная содержит объем возвращаемых данных. Если ZwQueryObject возвращает STATUS_BUFFER_OVERFLOW или STATUS_BUFFER_TOO_SMALL, можно использовать значение переменной для определения требуемого размера буфера.

Возвращаемое значение

ZwQueryObject возвращает STATUS_SUCCESS или соответствующее состояние ошибки. Возможные коды состояния ошибок включают следующие:

Возвращаемый код	Описание
STATUS_ACCESS_DENIED	Для выполнения этого запроса недостаточно разрешений.
STATUS_INVALID_HANDLE	Предоставленный дескриптор объекта недопустим.
STATUS_INFO_LENGTH_MISMATCH	Длина сведений недостаточно для хранения данных.

Замечания

Если вызов функции ZwQueryObject происходит в пользовательском режиме, следует использовать имя "NtQueryObject" вместо "ZwQueryObject".

Для вызовов драйверов в режиме ядра NtXxx и ZwXxx версии подпрограммы Windows Native System Services могут вести себя по-разному в том, как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связи между NtXxx и ZwXxx версиями подпрограммы см. в разделе Using Nt and Zw Versions of the Native System Services Routines.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000.
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h, FltKernel.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
правил соответствия DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

См. также

OBJECT_INFORMATION_CLASS

PUBLIC_OBJECT_BASIC_INFORMATION

PUBLIC_OBJECT_TYPE_INFORMATION

использование версий собственных системных служб и Zw

Поделиться через