Fungsi SHRegWriteUSValueA (shlwapi.h)

Menulis nilai ke subkey registri dalam subtree khusus pengguna (HKEY_CURRENT_USER atau HKEY_LOCAL_MACHINE).

Sintaks

LSTATUS SHRegWriteUSValueA(
  [in] HUSKEY     hUSKey,
  [in] LPCSTR     pszValue,
  [in] DWORD      dwType,
  [in] const void *pvData,
  [in] DWORD      cbData,
  [in] DWORD      dwFlags
);

Parameter

[in] hUSKey

Jenis: HUSKEY

Handel ke subkuntang registri yang saat ini terbuka. Sub-kunci harus telah dibuka dengan hak akses KEY_SET_VALUE. Untuk informasi selengkapnya, lihat Keamanan Kunci Registri dan Hak Akses.

Handel ini dapat diperoleh melalui fungsi SHRegOpenUSKey .

[in] pszValue

Jenis: LPCTSTR

Penunjuk ke string yang dihentikan null yang menentukan nama nilai. Nilai ini adalah entri dalam subkunjuk yang ditentukan oleh hUSKey. Jika nilai dengan nama ini belum ada di subkunji, nilai tersebut akan ditambahkan.

Jika parameter ini NULL atau string kosong, fungsi mengatur jenis dan data untuk nilai Default subkuncar.

[in] dwType

Jenis: DWORD

Jenis data yang akan disimpan dalam nilai yang ditentukan oleh pszValue. Salah satu jenis nilai registri berikut yang ditentukan dalam Winnt.h dan Wdm.h.

REG_NONE (0x00000000)

REG_SZ (0x00000001)

REG_EXPAND_SZ (0x00000002)

REG_BINARY (0x00000003)

REG_DWORD (0x00000004)

REG_DWORD_LITTLE_ENDIAN (0x00000004)

REG_DWORD_BIG_ENDIAN (0x00000005)

REG_LINK (0x00000006)

REG_MULTI_SZ (0x00000007)

REG_RESOURCE_LIST (0x00000008)

REG_FULL_RESOURCE_DESCRIPTOR (0x00000009)

REG_RESOURCE_REQUIREMENTS_LIST (0x0000000A)

REG_QWORD (0x0000000B)

REG_QWORD_LITTLE_ENDIAN (0x0000000B)

[in] pvData

Jenis: const void*

Penunjuk ke data yang akan diatur untuk nilai yang ditentukan oleh pszValue. Untuk jenis berbasis string, seperti REG_SZ, string harus dihentikan null. Dengan jenis data REG_MULTI_SZ, string harus dihentikan dengan dua karakter null. Garis miring terbalik di jalur harus didahului oleh garis miring terbalik lain sebagai karakter escape. Misalnya, tentukan "C:\mydir\myfile" untuk menyimpan string "C:\mydir\myfile".

[in] cbData

Jenis: DWORD

Ukuran, dalam byte, dari data yang diacu oleh parameter pvData . Jika data berjenis REG_SZ, REG_EXPAND_SZ, atau REG_MULTI_SZ, cbData harus menyertakan ukuran karakter atau karakter null yang mengakhiri.

[in] dwFlags

Jenis: DWORD

Bendera yang menunjukkan subtree tempat data harus ditulis. Satu atau beberapa nilai berikut ini:

SHREGSET_HKCU (0x00000001)

Tulis ke HKEY_CURRENT_USER hanya jika nilai nama yang ditentukan dalam pszValue saat ini tidak ada di bawah subkunji yang ditentukan.

SHREGSET_FORCE_HKCU (0x00000002)

Tulis ke HKEY_CURRENT_USER. Jika nilai nama yang ditentukan dalam pszValue sudah ada, itu akan ditimpa.

SHREGSET_HKLM (0x00000004)

Tulis ke HKEY_LOCAL_MACHINE hanya jika nilai nama yang ditentukan dalam pszValue saat ini tidak ada di bawah subkunji yang ditentukan..

SHREGSET_FORCE_HKLM (0x00000008)

Tulis ke HKEY_LOCAL_MACHINE. Jika nilai nama yang ditentukan dalam pszValue sudah ada, itu akan ditimpa.

SHREGSET_DEFAULT (0x00000006)

Setara dengan (SHREGSET_HKLM SHREGSET_FORCE_HKCU | ).

Nilai kembali

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 kesalahan.

Keterangan

Untuk menggunakan SHRegWriteUSValue, Anda harus terlebih dahulu membuka kunci dengan SHRegOpenUSKey. Setelah kunci dibuka, Anda dapat menggunakan SHRegWriteUSValue sebanyak yang diperlukan.

Jika Anda hanya perlu menulis satu nilai, Anda harus menggunakan SHRegSetUSValue, yang membuka kunci dan menulis nilai.

Jika Anda perlu menulis lebih dari satu nilai pada kunci yang sama, beberapa panggilan ke SHRegWriteUSValue biasanya lebih efisien daripada SHRegSetUSValue, karena kunci hanya dibuka sekali.

Catatan

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

Lihat juga

Jenis Nilai Registri