Bagikan melalui

Fungsi SHRegEnumUSValueA (shlwapi.h)

  • Artikel

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

Sintaks

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. Sub-kunci 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 yang dijumlahkan. 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 dari RegEnumValue.

[out, optional] pvData

Jenis: batal*

Penunjuk ke buffer yang menerima data untuk entri nilai. Ukuran buffer ini ditentukan dalam pcbData. Parameter ini bisa NULL jika data tidak diperlukan.

[in, out, optional] pcbData

Jenis: LPDWORD

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

Nilai kembali

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

Keterangan

Catatan

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

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)