Fungsi RegSetValueW (winreg.h)

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

Sintaksis

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 dibuka dengan hak akses KEY_SET_VALUE. Untuk informasi selengkapnya, lihat Keamanan Kunci Registri dan Hak Akses.

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

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

[in, optional] lpSubKey

Nama subkunjen parameter hKey. Fungsi ini mengatur 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 mengatur 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 dapat null.

[in] cbData

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

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

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

Komentar

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.

Persyaratan

Lihat juga

RegCreateKeyEx

RegFlushKey

RegOpenKeyEx

RegQueryValueEx

RegSetValueEx

Fungsi Registri

Gambaran Umum Registri