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 |