Fungsi SHRegSetValue (shlwapi.h)

Artikel
03/02/2024

Tidak didukung.

Menetapkan nilai registri.

Gunakan RegSetValue sebagai gantinya.

Sintaks

LSTATUS SHRegSetValue(
  [in] HKEY    hkey,
  [in] LPCWSTR pszSubKey,
  [in] LPCWSTR pszValue,
  [in] SRRF    srrfFlags,
  [in] DWORD   dwType,
  [in] 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] pszSubKey

Jenis: LPCWSTR

Penunjuk ke string yang dihentikan null yang menentukan jalur relatif dari hkey ke subkunci untuk mengambil nilai. Parameter ini dapat berupa NULL atau string kosong, dalam hal ini data diambil dari lokasi hkey .

[in] pszValue

Jenis: LPCWSTR

Penunjuk ke string yang dihentikan null yang berisi nama nilai. Parameter ini dapat berupa NULL atau string kosong, dalam hal ini data diambil dari nilai Default.

[in] srrfFlags

Jenis: SRRF

Satu atau beberapa bendera SRRF yang membatasi data untuk diatur. Setidaknya satu nilai pembatasan jenis (SRRF_RT) harus ditentukan.

[in] dwType

Jenis: DWORD

DWORD yang menunjukkan jenis data yang disimpan dalam nilai yang akan diatur. Saat menggunakan nilai default, input dwType adalah jenis nilai default. Untuk nilai yang mungkin, lihat Jenis Data Registri. Jika bendera SRRF_NOEXPAND tidak diatur, jenis REG_EXPAND_SZ secara otomatis diperluas dan dikembalikan sebagai REG_SZ. Jika informasi jenis tidak diperlukan, parameter ini bisa NULL.

[in] pvData

Jenis: LPCVOID

Penunjuk ke buffer yang berisi data nilai. Parameter ini bisa NULL jika data tidak diperlukan.

[in] cbData

Jenis: DWORD

Ukuran pvData buffer data sumber, dalam byte. Nilai ini bisa NULL hanya jika pvDataNULL.

Mengembalikan nilai

Jenis: LONG

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

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	shlwapi.h (termasuk Shlwapi.h)
DLL	Shlwapi.dll

Lihat juga

RegSetKeyValue

Bagikan melalui