Fungsi RtlCreateRegistryKey (wdm.h)

Artikel
02/29/2024

Rutinitas RtlCreateRegistryKey menambahkan objek kunci dalam registri di sepanjang jalur relatif tertentu.

Sintaks

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

Parameter

[in] RelativeTo

Menentukan apakah Jalur adalah jalur registri absolut atau relatif terhadap jalur kunci yang telah ditentukan sebelumnya sebagai salah satu dari berikut ini.

Nilai	Makna
RTL_REGISTRY_ABSOLUTE	Jalur adalah jalur registri absolut.
RTL_REGISTRY_SERVICES	Jalur relatif terhadap \Registry\Machine\System\CurrentControlSet\Services.
RTL_REGISTRY_CONTROL	Jalur relatif terhadap \Registry\Machine\System\CurrentControlSet\Control.
RTL_REGISTRY_WINDOWS_NT	Jalur relatif terhadap \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion.
RTL_REGISTRY_DEVICEMAP	Jalur relatif terhadap \Registry\Machine\Hardware\DeviceMap.
RTL_REGISTRY_USER	Jalur relatif terhadap \Registry\User\CurrentUser. (Untuk proses sistem, ini adalah \Users\. Default.)

[in] Path

Menentukan jalur registri sesuai dengan nilai RelativeTo .

Mengembalikan nilai

RtlCreateRegistryKey mengembalikan STATUS_SUCCESS jika kunci dibuat.

Keterangan

RtlCreateRegistryKey hanya membuat kunci yang Anda tentukan. Ini tidak membuat kunci yang hilang di jalur ke kunci yang ditentukan. Jika ada kunci di jalur yang hilang, panggilan akan gagal. Untuk memastikan bahwa semua kunci di jalur ada, Anda harus memanggil RtlCreateRegistryKey sekali untuk setiap kunci di jalur.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 2000 dan versi Windows yang lebih baru.
Target Platform	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL