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\。Default.) |
[in] Path
根據 RelativeTo 值指定登錄路徑。
傳回值
RtlCreateRegistryKey 會在建立密鑰時傳回STATUS_SUCCESS。
備註
RtlCreateRegistryKey 只會建立您指定的密鑰。 它不會在指定索引鍵的路徑中建立遺漏的索引鍵。 如果路徑中的任何索引鍵遺失,呼叫將會失敗。 若要確保路徑中的所有索引鍵都存在,您必須針對路徑中的每個索引 鍵呼叫 RtlCreateRegistryKey 一次。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows 2000 和更新版本的 Windows 中使用。 |
目標平台 | Universal |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |