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 |