Fungsi SHSetValueA (shlwapi.h)

  • Artikel

Mengatur nilai kunci registri.

Sintaks

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 untai (karakter) yang dihentikan null yang menentukan nama subkuntus yang nilainya terkait. Ini bisa 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 yang dihentikan null yang menentukan nilai . Nilai ini bisa 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 bisa NULL.

[in] cbData

Jenis: DWORD

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

Nilai kembali

Jenis: LSTATUS

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

Keterangan

Catatan

Header shlwapi.h mendefinisikan SHSetValue 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, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header shlwapi.h
Pustaka Shlwapi.lib
DLL Shlwapi.dll (versi 4.71 atau yang lebih baru)