(wdm.h) RtlCheckRegistryKey 函式

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。