RtlCreateRegistryKey 函数 (wdm.h)

RtlCreateRegistryKey 例程在注册表中沿给定的相对路径添加键对象。

语法

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

参数

[in] RelativeTo

指定 Path 是绝对注册表路径,还是相对于预定义的键路径,如下所示。

含义
RTL_REGISTRY_ABSOLUTE Path 是绝对注册表路径。
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\。Default.)

[in] Path

根据 RelativeTo 值指定注册表路径。

返回值

如果创建了密钥,RtlCreateRegistryKey 将返回STATUS_SUCCESS。

注解

RtlCreateRegistryKey 仅创建您指定的密钥。 它不会在指定密钥的路径中创建缺失的键。 如果路径中缺少任何密钥,调用将失败。 若要确保路径中的所有键都存在,必须为路径中的每个键调用 一次 RtlCreateRegistryKey

要求

要求
最低受支持的客户端 在 Windows 2000 和更高版本的 Windows 中可用。
目标平台 通用
标头 wdm.h(包括 Wdm.h、Ntddk.h、Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

另请参阅

RtlCheckRegistryKey

RtlDeleteRegistryValue

RtlQueryRegistryValues

RtlWriteRegistryValue

ZwEnumerateKey

ZwOpenKey