RtlCreateRegistryKey 関数 (wdm.h)

[アーティクル]
03/05/2024

RtlCreateRegistryKey ルーチンは、特定の相対パスに沿ってレジストリにキーオブジェクトを追加します。

構文

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

パラメーター

[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\ です。既定値)。)

[in] Path

RelativeTo 値に従ってレジストリパスを指定します。

戻り値

RtlCreateRegistryKey は、 キーが作成された場合STATUS_SUCCESSを返します。

注釈

RtlCreateRegistryKey では 、指定したキーのみが作成されます。指定したキーへのパスに不足しているキーは作成されません。パスにキーがない場合、呼び出しは失敗します。パス内のすべてのキーが存在することを確認するには、パス内のキーごとに RtlCreateRegistryKey を 1 回呼び出す必要があります。

要件

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