rtlCheckRegistryKey 函数 (wdm.h)

RtlCheckRegistryKey 例程检查注册表中是否存在给定的命名项。

语法

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

[in] RelativeTo

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

值	含义
RTL_REGISTRY_ABSOLUTE	Path 是绝对注册表路径。
RTL_REGISTRY_CONTROL	路径相对于 \Registry\Machine\System\CurrentControlSet\Control。
RTL_REGISTRY_DEVICEMAP	路径相对于 \Registry\Machine\Hardware\DeviceMap。
RTL_REGISTRY_SERVICES	路径相对于 \Registry\Machine\System\CurrentControlSet\Services。
RTL_REGISTRY_USER	路径相对于当前用户的注册表设置。 (对于系统进程，这是 \Users\。Default.) 这等效于用户模式下的HKEY_CURRENT_USER。
RTL_REGISTRY_WINDOWS_NT	路径相对于 \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion。
RTL_REGISTRY_HANDLE	此值不应传递到此例程中。尽管检查存在已打开的密钥的冗余，但它具有关闭传递的句柄的副作用。

[in] Path

根据 RelativeTo 值指定注册表路径。如果设置了RTL_REGISTRY_HANDLE， 则 Path 是直接使用的句柄。

如果给定的命名项位于给定相对路径的注册表中， 则 RtlCheckRegistryKey 返回STATUS_SUCCESS。