Функция RtlCreateRegistryKey (wdm.h)
Подпрограмма 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 |