Fungsi SHEnumValueA (shlwapi.h)

Menghitung nilai kunci registri terbuka yang ditentukan.

Sintaksis

LSTATUS SHEnumValueA(
  [in]                HKEY    hkey,
  [in]                DWORD   dwIndex,
                      PSTR    pszValueName,
  [in, out, optional] LPDWORD pcchValueName,
  [out, optional]     LPDWORD pdwType,
                      void    *pvData,
  [in, out, optional] LPDWORD 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] dwIndex

Jenis: DWORD

Indeks nilai yang akan diambil. Parameter ini harus nol untuk panggilan pertama dan dinaikkan untuk panggilan berikutnya.

pszValueName

Jenis: LPTSTR

Alamat buffer karakter yang menerima nama nilai enumerasi. Ukuran buffer ini ditentukan dalam pcchValueName.

[in, out, optional] pcchValueName

Jenis: LPDWORD

Alamat DWORD yang, pada entri, berisi ukuran buffer di pszValueName, dalam karakter. Saat keluar, ini berisi jumlah karakter yang disalin ke pszValueName.

[out, optional] pdwType

Jenis: LPDWORD

Alamat DWORD yang menerima jenis data nilai. Ini adalah nilai yang sama seperti yang dijelaskan di bawah parameter lpType RegEnumValue.

pvData

Jenis: LPVOID

Alamat buffer yang menerima data untuk entri nilai. Ukuran buffer ini ditentukan dalam pcbData. Parameter ini dapat NULL jika data tidak diperlukan.

[in, out, optional] pcbData

Jenis: LPDWORD

Alamat DWORD yang, pada entri, berisi ukuran buffer di pvData, dalam byte. Saat keluar, ini berisi jumlah byte yang disalin ke pvData.

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

Komentar

Persyaratan