Fungsi RegSetValueW (winreg.h)

Artikel
03/04/2024

Mengatur data untuk nilai default atau tidak disebutkan namanya dari kunci registri tertentu. Data harus berupa string teks.

Catatan Fungsi ini disediakan hanya untuk kompatibilitas dengan Windows versi 16-bit. Aplikasi harus menggunakan fungsi RegSetValueEx .

Sintaks

LSTATUS RegSetValueW(
  [in]           HKEY    hKey,
  [in, optional] LPCWSTR lpSubKey,
  [in]           DWORD   dwType,
  [in]           LPCWSTR lpData,
  [in]           DWORD   cbData
);

Parameter

[in] hKey

Handel ke kunci registri terbuka. Kunci harus telah dibuka dengan hak akses KEY_SET_VALUE. Untuk informasi selengkapnya, lihat Keamanan Kunci Registri dan Hak Akses.

Handel ini dikembalikan oleh fungsi RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyEx, atau RegOpenKeyTransacted . Ini juga bisa menjadi salah satu kunci yang telah ditentukan sebelumnya berikut:

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

[in, optional] lpSubKey

Nama subkunjuk dari parameter hKey . Fungsi ini menetapkan nilai default subkunjuk yang ditentukan. Jika lpSubKey tidak ada, fungsi akan membuatnya.

Nama kunci tidak peka huruf besar/kecil.

Jika parameter ini NULL atau menunjuk ke string kosong, fungsi menetapkan nilai default kunci yang diidentifikasi oleh hKey.

Untuk informasi selengkapnya, lihat Batas Ukuran Elemen Registri.

[in] dwType

Jenis informasi yang akan disimpan. Parameter ini harus berupa jenis REG_SZ. Untuk menyimpan jenis data lainnya, gunakan fungsi RegSetValueEx .

[in] lpData

Data yang akan disimpan. Parameter ini tidak boleh NULL.

[in] cbData

Parameter diabaikan Fungsi menghitung nilai ini berdasarkan ukuran data dalam parameter lpData .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan bukan nol yang ditentukan dalam Winerror.h. Anda dapat menggunakan fungsi FormatMessage dengan bendera FORMAT_MESSAGE_FROM_SYSTEM untuk mendapatkan deskripsi umum tentang kesalahan tersebut.

Keterangan

Jika kunci yang ditentukan oleh parameter lpSubKey tidak ada, fungsi RegSetValue membuatnya.

Jika versi ANSI dari fungsi ini digunakan (baik dengan secara eksplisit memanggil RegSetValueA atau dengan tidak menentukan UNICODE sebelum menyertakan file Windows.h), parameter lpData harus berupa string karakter ANSI. String dikonversi ke Unicode sebelum disimpan dalam registri.

Catatan

Header winreg.h mendefinisikan RegSetValue sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winreg.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll