Fungsi SHGetValueA (shlwapi.h)

Mengambil nilai registri.

Sintaksis

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 untai (karakter) yang dihentikan null yang menentukan nama subkuncar 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 tentang kesalahan tersebut.

Komentar

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.

Persyaratan