Fungsi SHSetValueA (shlwapi.h)

Artikel
20/11/2024

Mengatur nilai kunci registri.

Sintaksis

C++

LSTATUS SHSetValueA(
  [in]           HKEY    hkey,
  [in, optional] LPCSTR  pszSubKey,
  [in, optional] LPCSTR  pszValue,
  [in]           DWORD   dwType,
  [in, optional] LPCVOID pvData,
  [in]           DWORD   cbData
);

Parameter

[in] hkey

Jenis: HKEY

Handel ke kunci yang saat ini terbuka, atau salah satu nilai yang telah ditentukan sebelumnya berikut ini.

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_PERFORMANCE_DATA

HKEY_USERS

[in, optional] pszSubKey

Jenis: LPCTSTR

Alamat string yang dihentikan null yang menentukan nama subkunjuk dengan nilai yang terkait. Ini dapat NULL atau penunjuk ke string kosong. Dalam hal ini, nilai ditambahkan ke kunci yang diidentifikasi oleh parameter hkey .

[in, optional] pszValue

Jenis: LPCTSTR

Alamat string null-terminated yang menentukan nilai . Nilai ini dapat null.

[in] dwType

Jenis: DWORD

Jenis data yang akan disimpan. Parameter ini harus berupa jenis REG_SZ. Untuk informasi selengkapnya, lihat Jenis Data Registri.

[in, optional] pvData

Jenis: LPCVOID

Penunjuk ke buffer yang berisi data yang akan diatur untuk nilai yang ditentukan. Nilai ini dapat null.

[in] cbData

Jenis: DWORD

Panjang, dalam byte, dari buffer yang ditujukkan oleh parameter pvData . Jika data adalah string yang dihentikan null, panjang ini mencakup karakter null yang mengakhiri.

Mengembalikan nilai

Jenis: LSTATUS

Mengembalikan ERROR_SUCCESS jika berhasil; jika tidak, kode kesalahan bukan nol yang ditentukan dalam Winerror.h. Anda dapat menggunakan fungsi FormatMessage dengan bendera FORMAT_MESSAGE_FROM_SYSTEM untuk mengambil deskripsi umum tentang kesalahan tersebut.

Komentar

Catatan

Header shlwapi.h mendefinisikan SHSetValue sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor 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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	shlwapi.h
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll (versi 4.71 atau yang lebih baru)

Bagikan melalui