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

Статья
08/08/2023

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

Синтаксис

NTSYSAPI NTSTATUS RtlCheckRegistryKey(
  [in] ULONG RelativeTo,
  [in] PWSTR Path
);

Параметры

[in] RelativeTo

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

Значение	Значение
RTL_REGISTRY_ABSOLUTE	Путь — это абсолютный путь к реестру.
RTL_REGISTRY_CONTROL	Путь относительно \Registry\Machine\System\CurrentControlSet\Control.
RTL_REGISTRY_DEVICEMAP	Путь относительно \Registry\Machine\Hardware\DeviceMap.
RTL_REGISTRY_SERVICES	Путь относительно \Registry\Machine\System\CurrentControlSet\Services.
RTL_REGISTRY_USER	Путь относительно параметров реестра для текущего пользователя. (Для системного процесса это \Users\. По умолчанию.) Это эквивалентно HKEY_CURRENT_USER в пользовательском режиме.
RTL_REGISTRY_WINDOWS_NT	Путь относительно \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion.
RTL_REGISTRY_HANDLE	Это значение не должно передаваться в эту подпрограмму. Несмотря на избыточность проверка на наличие уже открытого ключа, он имеет побочный эффект закрытия переданного маркера.

[in] Path

Указывает путь к реестру в соответствии со значением RelativeTo . Если задано RTL_REGISTRY_HANDLE, path — это дескриптор, который будет использоваться напрямую.

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

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

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows 2000 и более поздних версиях Windows.
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

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

RtlQueryRegistryValues

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