共用方式為


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

另請參閱

RtlCheckRegistryKey

RtlDeleteRegistryValue

RtlQueryRegistryValues

RtlWriteRegistryValue

ZwEnumerateKey

ZwOpenKey