Fungsi RegSetKeyValueA (winreg.h)

  • Artikel

Mengatur data untuk nilai yang ditentukan dalam kunci registri dan subkuntang yang ditentukan.

Sintaks

LSTATUS RegSetKeyValueA(
  [in]           HKEY    hKey,
  [in, optional] LPCSTR  lpSubKey,
  [in, optional] LPCSTR  lpValueName,
  [in]           DWORD   dwType,
  [in, optional] LPCVOID 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 subkey relatif terhadap kunci yang diidentifikasi oleh hKey. Jika subkunci tidak ada, subkunci dibuat sebagai kunci non-volatil dengan deskriptor keamanan default. Jika parameter ini NULL, maka nilai dibuat dalam kunci yang ditentukan oleh hKey.

[in, optional] lpValueName

Nama nilai registri yang datanya akan diperbarui.

[in] dwType

Jenis data yang ditujukkan oleh parameter lpData . Untuk daftar jenis yang mungkin, lihat Jenis Nilai Registri.

[in, optional] lpData

Data yang akan disimpan dengan nama nilai yang ditentukan.

Untuk jenis berbasis string, seperti REG_SZ, string harus dihentikan null. Dengan jenis data REG_MULTI_SZ, string harus dihentikan dengan dua karakter null.

[in] cbData

Ukuran informasi yang ditujukkan oleh parameter lpData , dalam byte. Jika data berjenis REG_SZ, REG_EXPAND_SZ, atau REG_MULTI_SZ, cbData harus menyertakan ukuran karakter atau karakter null yang mengakhiri.

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

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0600 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Catatan

Header winreg.h mendefinisikan RegSetKeyValue sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur 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 Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header winreg.h (termasuk Windows.h)
Pustaka Advapi32.lib
DLL Advapi32.dll

Lihat juga

RegDeleteKeyValue

Fungsi Registri