Bagikan melalui

Fungsi SHRegQueryInfoUSKeyA (shlwapi.h)

  • Artikel

Mengambil informasi tentang subkey registri tertentu dalam subtree khusus pengguna (HKEY_CURRENT_USER atau HKEY_LOCAL_MACHINE).

Sintaks

LSTATUS SHRegQueryInfoUSKeyA(
  [in]            HUSKEY          hUSKey,
  [out, optional] LPDWORD         pcSubKeys,
  [out, optional] LPDWORD         pcchMaxSubKeyLen,
  [out, optional] LPDWORD         pcValues,
  [out, optional] LPDWORD         pcchMaxValueNameLen,
  [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 .

[out, optional] pcSubKeys

Jenis: LPDWORD

Penunjuk ke DWORD yang menerima jumlah subkunci di bawah kunci yang ditentukan.

[out, optional] pcchMaxSubKeyLen

Jenis: LPDWORD

Penunjuk ke DWORD yang menerima jumlah karakter dalam nama subkunci terbesar.

[out, optional] pcValues

Jenis: LPDWORD

Penunjuk ke DWORD yang menerima jumlah nilai di bawah kunci yang ditentukan.

[out, optional] pcchMaxValueNameLen

Jenis: LPDWORD

Penunjuk ke DWORD yang menerima jumlah karakter dalam nama nilai terbesar.

[in] enumRegFlags

Jenis: SHREGENUM_FLAGS

Salah satu SHREGENUM_FLAGS yang menentukan kunci dasar tempat kueri 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 tentang kesalahan.

Keterangan

Catatan

Header shlwapi.h mendefinisikan SHRegQueryInfoUSKey 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

   
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)