Функция ZwQueryValueKey (wdm.h)

Статья
02/27/2024

Подпрограмма ZwQueryValueKey возвращает запись значения для раздела реестра.

Синтаксис

NTSYSAPI NTSTATUS ZwQueryValueKey(
  [in]            HANDLE                      KeyHandle,
  [in]            PUNICODE_STRING             ValueName,
  [in]            KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass,
  [out, optional] PVOID                       KeyValueInformation,
  [in]            ULONG                       Length,
  [out]           PULONG                      ResultLength
);

Параметры

[in] KeyHandle

Дескриптор к ключу для чтения записей значений. Этот дескриптор создается путем успешного вызова ZwCreateKey или ZwOpenKey.

[in] ValueName

Указатель на имя записи значения для получения данных.

[in] KeyValueInformationClass

Значение KEY_VALUE_INFORMATION_CLASS , определяющее тип сведений, возвращаемых в буфере KeyValueInformation .

[out, optional] KeyValueInformation

Указатель на буфер, выделенный вызывающим объектом, который получает запрошенные сведения.

[in] Length

Указывает размер (в байтах) буфера KeyValueInformation .

[out] ResultLength

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

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

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

Код возврата	Описание
STATUS_OBJECT_NAME_NOT_FOUND	Значение реестра недоступно.
STATUS_BUFFER_OVERFLOW	Предоставленный буфер слишком мал, и в него записаны только частичные данные. Для параметра ResultLength задан минимальный размер, необходимый для хранения запрошенных сведений.
STATUS_BUFFER_TOO_SMALL	Предоставленный буфер слишком мал, и никакие данные не были записаны в буфер. Для параметра ResultLength задан минимальный размер, необходимый для хранения запрошенных сведений.
STATUS_INVALID_PARAMETER	Параметр KeyInformationClass не является допустимым KEY_VALUE_INFORMATION_CLASS значением.

Ключ KeyHandle, переданный в ZwQueryValueKey, должен быть открыт с KEY_QUERY_VALUE доступом. Это достигается путем передачи KEY_QUERY_VALUE, KEY_READ или KEY_ALL_ACCESS в качестве параметра DesiredAccessв ZwCreateKey или ZwOpenKey.

Дополнительные сведения о работе с разделами реестра см. в статье Использование реестра в драйвере.

Если вызов этой функции выполняется в пользовательском режиме, следует использовать имя NtQueryValueKey вместо ZwQueryValueKey. Для вызовов из драйверов режима ядра версии NtXxx и ZwXxx подпрограммы Собственные системные службы Windows могут вести себя по-разному, так как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связи между версиями подпрограмм NtXxx и ZwXxx см. в разделе Использование версий NT и Zw подпрограмм собственных системных служб.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Правила соответствия DDI	HwStorPortProhibitedDIs(storport), IrqlZwPassive(wdm), PowerIrpDDis(wdm), ZwRegistryCreate(storport), ZwRegistryCreate(storport), ZwRegistryCreate(wdm), ZwRegistryOpen(storport), ZwRegistryOpen(storport), ZwRegistryOpen(wdm)