RtlWriteRegistryValue 函数 (wdm.h)

项目
02/27/2024

RtlWriteRegistryValue 例程将调用方提供的数据沿给定值名称处的指定相对路径写入注册表。

语法

NTSYSAPI NTSTATUS RtlWriteRegistryValue(
  [in]           ULONG  RelativeTo,
  [in]           PCWSTR Path,
  [in]           PCWSTR ValueName,
  [in]           ULONG  ValueType,
  [in, optional] PVOID  ValueData,
  [in]           ULONG  ValueLength
);

参数

[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.)
RTL_REGISTRY_OPTIONAL	指定此参数和 Path 参数引用的键是可选的。
RTL_REGISTRY_HANDLE	指定 Path 参数实际上是要使用的注册表句柄。此值是可选的。

[in] Path

指向绝对注册表路径或相对于 RelativeTo 参数指定的已知位置的路径的指针。如果指定了RTL_REGISTRY_HANDLE标志，则此参数是已打开的项的注册表句柄，可直接使用。

[in] ValueName

指向要写入注册表的子项或值项的名称的指针。

[in] ValueType

指定确定 ValueName 参数类型的 REG_XXX 值。有关可能值的列表，请参阅 ZwSetValueKey 的 Type 参数。

[in, optional] ValueData

指向子项的名称的指针，或子项的值条目 (或两者都) 要写入注册表。

[in] ValueLength

指定要写入注册表的 ValueData 的字节数。

返回值

RtlWriteRegistryValue 返回操作的状态，STATUS_SUCCESS或错误状态。

注解

如果指定的键不存在，则例程将尝试创建该键。要使此尝试成功，新密钥必须是 Path 参数引用的键的直接子项，并且 Path 引用的密钥必须已打开才能KEY_CREATE_SUB_KEY访问。

要求

要求	值
最低受支持的客户端	从 Windows 2000 开始可用。
目标平台	通用
标头	wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL