Fungsi SHRegEnumUSKeyA (shlwapi.h)

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

Sintaksis

LSTATUS SHRegEnumUSKeyA(
  [in]      HUSKEY          hUSKey,
  [in]      DWORD           dwIndex,
  [out]     LPSTR           pszName,
  [in, out] LPDWORD         pcchName,
  [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 subkunde yang akan diambil. Parameter ini harus nol untuk panggilan pertama dan dinaikkan untuk panggilan berikutnya.

[out] pszName

Jenis: LPTSTR

Penunjuk ke buffer karakter yang menerima nama kunci enumerasi.

[in, out] pcchName

Jenis: LPDWORD

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

[in] enumRegFlags

Jenis: SHREGENUM_FLAGS

SHREGENUM_FLAGS yang menentukan kunci dasar tempat enumerasi harus dilakukan.

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 SHRegEnumUSKey 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)