Fungsi SHGetValueA (shlwapi.h)
Mengambil nilai registri.
Sintaks
LSTATUS SHGetValueA(
[in] HKEY hkey,
[in, optional] LPCSTR pszSubKey,
[in, optional] LPCSTR pszValue,
[out, optional] DWORD *pdwType,
[out, optional] void *pvData,
[in, out, optional] DWORD *pcbData
);
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, optional] pszSubKey
Jenis: LPCTSTR
Alamat string yang dihentikan null yang menentukan nama subkunji tempat untuk mengambil nilai.
[in, optional] pszValue
Jenis: LPCTSTR
Alamat nilai.
[out, optional] pdwType
Jenis: LPDWORD
Jenis nilai. Untuk informasi selengkapnya, lihat Jenis Data Registri.
[out, optional] pvData
Jenis: LPVOID
Alamat buffer data tujuan.
[in, out, optional] pcbData
Jenis: LPDWORD
Ukuran buffer data tujuan.
Mengembalikan nilai
Jenis: LSTATUS
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.
Keterangan
Jika aplikasi Anda harus mengatur/mengambil serangkaian nilai dalam kunci yang sama, lebih baik membuka kunci sekali dan mengatur/mengambil nilai dengan fungsi registri Microsoft Win32 reguler daripada menggunakan fungsi ini berulang kali.
Catatan
Header shlwapi.h mendefinisikan SHGetValue 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) |