Bagikan melalui

Fungsi SHRegSetUSValueA (shlwapi.h)

  • Artikel

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

Sintaks

LSTATUS SHRegSetUSValueA(
  [in]           LPCSTR     pszSubKey,
  [in]           LPCSTR     pszValue,
  [in]           DWORD      dwType,
  [in, optional] const void *pvData,
  [in, optional] DWORD      cbData,
  [in, optional] DWORD      dwFlags
);

Parameter

[in] pszSubKey

Jenis: LPCTSTR

Penunjuk ke string yang dihentikan null dengan nama subkunci.

[in] pszValue

Jenis: LPCTSTR

Penunjuk ke string yang dihentikan null yang menentukan nama nilai.

[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 | ).

Nilai kembali

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

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)