RtlCheckRegistryKey 関数 (wdm.h)

RtlCheckRegistryKey ルーチンは、指定された名前付きキーがレジストリに存在することを確認します。

構文

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

[in] RelativeTo

Path が絶対レジストリパスであるか、定義済みのキーパスに対する相対パスであるかを次のように指定します。

値	意味
RTL_REGISTRY_ABSOLUTE	パスは絶対レジストリパスです。
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\ です。既定値)。)これは、ユーザーモードでの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を返します。

要件	値
サポートされている最小のクライアント	Windows 2000 以降のバージョンの Windows で使用できます。
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	PASSIVE_LEVEL