Fungsi SHRegWriteUSValueW (shlwapi.h)
Menulis nilai ke subkuntang registri dalam subtree khusus pengguna (HKEY_CURRENT_USER atau HKEY_LOCAL_MACHINE).
Sintaks
LSTATUS SHRegWriteUSValueW(
[in] HUSKEY hUSKey,
LPCWSTR pwzValue,
[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. Subkunjud harus dibuka dengan hak akses KEY_SET_VALUE. Untuk informasi selengkapnya, lihat Keamanan Kunci Registri dan Hak Akses.
Handel ini dapat diperoleh melalui fungsi SHRegOpenUSKey .
pwzValue
TBD
[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 subkuntang 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 subkuntang 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 didefinisikan 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 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) |