Fungsi SHRegEnumUSKeyA (shlwapi.h)

Artikel
03/02/2024

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

Sintaks

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. Subkunjud harus 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 yang dijumlahkan.

[in, out] pcchName

Jenis: LPDWORD

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

Nilai kembali

Jenis: LSTATUS

Mengembalikan ERROR_SUCCESS jika berhasil, atau kode kesalahan bukan nol yang ditentukan dalam Winerror.h sebaliknya. Anda dapat menggunakan fungsi FormatMessage dengan bendera FORMAT_MESSAGE_FROM_SYSTEM untuk mengambil deskripsi tekstual kesalahan.

Keterangan

Catatan

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

Bagikan melalui