Функция RtlQueryRegistryValueWithFallback (ntddk.h)

Статья
02/07/2025

Извлекает запись значения для раздела реестра с помощью основного дескриптора; Если не найдено, использует резервный дескриптор.

Синтаксис

NTSYSAPI NTSTATUS RtlQueryRegistryValueWithFallback(
  [in]  HANDLE          PrimaryHandle,
  [in]  HANDLE          FallbackHandle,
  [in]  PUNICODE_STRING ValueName,
  [in]  ULONG           ValueLength,
  [Out] PULONG          ValueType,
  [out] PVOID           ValueData,
  [out] PULONG          ResultLength
);

Параметры

[in] PrimaryHandle

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

[in] FallbackHandle

Дескриптор, используемый для запроса ключа, если значение не найдено с помощью дескриптора, указанного PrimaryHandle.

[in] ValueName

Указатель на строку, содержащую имя значения, для которого необходимо получить данные.

[in] ValueLength

Задает размер строки ValueName в байтах.

[Out] ValueType

Указатель на переменную ULONG, которая получает тип запрашиваемого значения.

[out] ValueData

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

[out] ResultLength

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

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1809
заголовка	ntddk.h (include wdm.h)
библиотеки	NtosKrnl.lib
IRQL	PASSIVE_LEVEL

См. также

Использование реестра в драйвера

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