Fungsi RtlWriteRegistryValue (wdm.h)

Artikel
08/08/2023

Rutinitas RtlWriteRegistryValue menulis data yang disediakan pemanggil ke dalam registri di sepanjang jalur relatif yang ditentukan pada nama nilai yang diberikan.

Sintaks

NTSYSAPI NTSTATUS RtlWriteRegistryValue(
  [in]           ULONG  RelativeTo,
  [in]           PCWSTR Path,
  [in]           PCWSTR ValueName,
  [in]           ULONG  ValueType,
  [in, optional] PVOID  ValueData,
  [in]           ULONG  ValueLength
);

Parameter

[in] RelativeTo

Menentukan apakah Jalur adalah jalur registri absolut atau relatif terhadap jalur 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.)
RTL_REGISTRY_OPTIONAL	Menentukan bahwa kunci yang dirujuk oleh parameter ini dan parameter Jalur bersifat opsional.
RTL_REGISTRY_HANDLE	Menentukan bahwa parameter Path sebenarnya adalah handel registri untuk digunakan. Nilai ini opsional.

[in] Path

Penunjuk ke jalur registri absolut atau jalur yang relatif terhadap lokasi yang diketahui yang ditentukan oleh parameter RelativeTo . Jika bendera RTL_REGISTRY_HANDLE ditentukan, parameter ini adalah handel registri untuk kunci yang sudah dibuka untuk digunakan secara langsung.

[in] ValueName

Arahkan ke nama subkunci atau entri nilai yang akan ditulis ke dalam registri.

[in] ValueType

Menentukan nilai REG_XXX yang menentukan jenis parameter ValueName . Untuk daftar nilai yang mungkin, lihat Parameter jenisZwSetValueKey.

[in, optional] ValueData

Arahkan ke nama subkunci atau nilai untuk entri nilainya (atau keduanya) yang akan ditulis ke dalam registri.

[in] ValueLength

Menentukan jumlah byte ValueData yang akan ditulis ke dalam registri.

Mengembalikan nilai

RtlWriteRegistryValue mengembalikan status operasi, baik STATUS_SUCCESS atau status kesalahan.

Keterangan

Jika kunci yang ditentukan tidak ada, rutin mencoba membuat kunci. Agar upaya ini berhasil, kunci baru harus berupa subkunci langsung dari kunci yang disebut oleh parameter Path , dan kunci yang dirujuk Path harus dibuka untuk akses KEY_CREATE_SUB_KEY.

Persyaratan

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