RtlCreateRegistryKey 関数 (wdm.h)
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 |