Fungsi SHQueryValueExA (shlwapi.h)

Membuka kunci registri dan mengkuerinya untuk nilai tertentu.

Sintaks

LSTATUS SHQueryValueExA(
  [in]                HKEY   hkey,
  [in, optional]      LPCSTR pszValue,
                      DWORD  *pdwReserved,
  [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] pszValue

Jenis: LPCTSTR

Alamat string yang dihentikan null yang berisi nama nilai yang akan dikueri.

pdwReserved

Jenis: LPDWORD

Dicadangkan. Harus NULL.

[out, optional] pdwType

Jenis: LPDWORD

Alamat variabel yang menerima jenis nilai kunci. Untuk informasi selengkapnya, lihat Jenis Data Registri.

[out, optional] pvData

Jenis: LPVOID

Alamat buffer yang menerima data nilai. Parameter ini bisa NULL jika data tidak diperlukan.

[in, out, optional] pcbData

Jenis: LPDWORD

Alamat variabel yang menentukan ukuran, dalam byte, dari buffer yang diacu oleh parameter pvData . Ketika fungsi kembali, variabel ini berisi ukuran data yang disalin ke pvData.

Mengembalikan nilai

Jenis: DWORD

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

Catatan

Header shlwapi.h mendefinisikan SHQueryValueEx 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)