Bagikan melalui

Fungsi SHQueryInfoKeyW (shlwapi.h)

  • Artikel

Mengambil informasi tentang kunci registri tertentu.

Sintaks

LSTATUS SHQueryInfoKeyW(
  [in]            HKEY    hkey,
  [out, optional] LPDWORD pcSubKeys,
  [out, optional] LPDWORD pcchMaxSubKeyLen,
  [out, optional] LPDWORD pcValues,
  [out, optional] LPDWORD pcchMaxValueNameLen
);

Parameter

[in] hkey

Jenis: HKEY

Handel ke kunci yang saat ini terbuka, atau salah satu nilai yang telah ditentukan sebelumnya berikut ini.

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_PERFORMANCE_DATA

HKEY_USERS

[out, optional] pcSubKeys

Jenis: LPDWORD

Alamat DWORD yang menerima jumlah subkunci di bawah kunci yang ditentukan.

[out, optional] pcchMaxSubKeyLen

Jenis: LPDWORD

Alamat DWORD yang menerima jumlah karakter dalam nama subkunci dengan nama terbesar.

[out, optional] pcValues

Jenis: LPDWORD

Alamat DWORD yang menerima jumlah nilai di bawah kunci yang ditentukan.

[out, optional] pcchMaxValueNameLen

Jenis: LPDWORD

Alamat DWORD yang menerima jumlah karakter dalam nama nilai dengan nama terbesar.

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