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

Статья
08/08/2023

Подпрограмма RtlCreateRegistryKey добавляет объект ключа в реестр по заданному относительному пути.

Синтаксис

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

Параметры

[in] RelativeTo

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

Значение	Значение
RTL_REGISTRY_ABSOLUTE	Путь — это абсолютный путь к реестру.
RTL_REGISTRY_SERVICES	Путь относительно \Registry\Machine\System\CurrentControlSet\Services.
RTL_REGISTRY_CONTROL	Путь относительно \Registry\Machine\System\CurrentControlSet\Control.
RTL_REGISTRY_WINDOWS_NT	Путь относительно \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion.
RTL_REGISTRY_DEVICEMAP	Путь относительно \Registry\Machine\Hardware\DeviceMap.
RTL_REGISTRY_USER	Путь относительно \Registry\User\CurrentUser. (Для системного процесса это \Users\. По умолчанию.)

[in] Path

Указывает путь к реестру в соответствии со значением RelativeTo .

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

RtlCreateRegistryKey возвращает STATUS_SUCCESS, если ключ создан.

RtlCreateRegistryKey создает только указанные ключи. Он не создает отсутствующие ключи в пути к указанному ключу. Если какие-либо ключи в пути отсутствуют, вызов завершится ошибкой. Чтобы убедиться, что все ключи в пути существуют, необходимо вызвать RtlCreateRegistryKey один раз для каждого ключа в пути.

Требования

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