Fungsi SHRegEnumUSValueA (shlwapi.h)

Menghitung nilai subkuntang registri yang ditentukan dalam subtree khusus pengguna (HKEY_CURRENT_USER atau HKEY_LOCAL_MACHINE).

Sintaksis

LSTATUS SHRegEnumUSValueA(
  [in]                HUSKEY          hUSkey,
  [in]                DWORD           dwIndex,
  [out]               LPSTR           pszValueName,
  [in, out]           LPDWORD         pcchValueName,
  [out, optional]     LPDWORD         pdwType,
  [out, optional]     void            *pvData,
  [in, out, optional] LPDWORD         pcbData,
  [in]                SHREGENUM_FLAGS enumRegFlags
);

Parameter

[in] hUSkey

Jenis: HUSKEY

Handel ke subkuntang registri yang saat ini terbuka. Subkunjuk harus telah dibuka dengan hak akses KEY_SET_VALUE. Untuk informasi selengkapnya, lihat Keamanan Kunci Registri dan Hak Akses.

Handel ini dapat diperoleh melalui fungsi SHRegOpenUSKey.

[in] dwIndex

Jenis: DWORD

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

[out] pszValueName

Jenis: LPTSTR

Penunjuk ke buffer karakter yang menerima nama nilai enumerasi. Ukuran buffer ini ditentukan dalam pcchValueNameLen.

[in, out] pcchValueName

Jenis: LPDWORD

Penunjuk ke 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

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

[out, optional] pvData

Jenis: batal*

Penunjuk ke 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

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

[in] enumRegFlags

Jenis: SHREGENUM_FLAGS

Salah satu SHREGENUM_FLAGS yang menentukan kunci dasar tempat enumerasi harus berlangsung.

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

Nota

Header shlwapi.h mendefinisikan SHRegEnumUSValue sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	shlwapi.h
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll (versi 4.71 atau yang lebih baru)