Fungsi SHRegSetUSValueW (shlwapi.h)

Mengatur nilai subkuntang registri dalam subtree khusus pengguna (HKEY_CURRENT_USER atau HKEY_LOCAL_MACHINE).

Sintaks

LSTATUS SHRegSetUSValueW(
                 LPCWSTR    pwzSubKey,
                 LPCWSTR    pwzValue,
  [in]           DWORD      dwType,
  [in, optional] const void *pvData,
  [in, optional] DWORD      cbData,
  [in, optional] DWORD      dwFlags
);

Parameter

pwzSubKey

TBD

pwzValue

TBD

[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: LPVOID*

Apointer ke string yang dihentikan null yang berisi nilai yang akan diatur untuk kunci yang ditentukan.

[in, optional] cbData

Jenis: DWORD

Panjang, dalam byte, dari string yang diacu oleh parameter pvData , tidak termasuk karakter null yang mengakhiri.

[in, optional] dwFlags

Jenis: DWORD

Bendera yang menunjukkan di mana data harus ditulis.

SHREGSET_HKCU

Tulis ke HKEY_CURRENT_USER jika kosong.

SHREGSET_FORCE_HKCU

Tulis ke HKEY_CURRENT_USER.

SHREGSET_HKLM

Tulis ke HKEY_LOCAL_MACHINE jika kosong.

SHREGSET_FORCE_HKLM

Tulis ke HKEY_LOCAL_MACHINE.

SHREGSET_DEFAULT

Setara dengan (SHREGSET_HKLM SHREGSET_FORCE_HKCU | ).

Mengembalikan nilai

Jenis: LSTATUS

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

Keterangan

Fungsi ini membuka kunci setiap kali digunakan. Jika kode Anda melibatkan pengaturan serangkaian nilai dalam kunci yang sama, lebih efisien untuk membuka kunci sekali dengan SHRegOpenUSKey lalu menggunakan SHRegWriteUSValue untuk menulis data.

Catatan

Header shlwapi.h mendefinisikan SHRegSetUSValue 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

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)