Fungsi RegQueryInfoKeyA (winreg.h)

Artikel
03/08/2023

Mengambil informasi tentang kunci registri yang ditentukan.

Sintaks

LSTATUS RegQueryInfoKeyA(
  [in]                HKEY      hKey,
  [out, optional]     LPSTR     lpClass,
  [in, out, optional] LPDWORD   lpcchClass,
                      LPDWORD   lpReserved,
  [out, optional]     LPDWORD   lpcSubKeys,
  [out, optional]     LPDWORD   lpcbMaxSubKeyLen,
  [out, optional]     LPDWORD   lpcbMaxClassLen,
  [out, optional]     LPDWORD   lpcValues,
  [out, optional]     LPDWORD   lpcbMaxValueNameLen,
  [out, optional]     LPDWORD   lpcbMaxValueLen,
  [out, optional]     LPDWORD   lpcbSecurityDescriptor,
  [out, optional]     PFILETIME lpftLastWriteTime
);

Parameter

[in] hKey

Handel ke kunci registri terbuka. Kunci harus dibuka dengan hak akses KEY_QUERY_VALUE. Untuk informasi selengkapnya, lihat Keamanan Kunci Registri dan Hak Akses.

Handel ini dikembalikan oleh fungsi RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyEx, atau RegOpenKeyTransacted . Ini juga bisa menjadi salah satu kunci yang telah ditentukan sebelumnya berikut:


   HKEY_CLASSES_ROOT
   HKEY_CURRENT_CONFIG
   HKEY_CURRENT_USER
   HKEY_LOCAL_MACHINE
   HKEY_PERFORMANCE_DATA
   HKEY_USERS

[out, optional] lpClass

Penunjuk ke buffer yang menerima kelas kunci yang ditentukan pengguna. Parameter ini bisa NULL.

[in, out, optional] lpcchClass

Penunjuk ke variabel yang menentukan ukuran buffer yang diacu oleh parameter lpClass , dalam karakter.

Ukuran harus mencakup karakter null yang mengakhiri. Saat fungsi kembali, variabel ini berisi ukuran string kelas yang disimpan dalam buffer. Jumlah yang dikembalikan tidak termasuk karakter null yang mengakhiri. Jika buffer tidak cukup besar, fungsi mengembalikan ERROR_MORE_DATA, dan variabel berisi ukuran string, dalam karakter, tanpa menghitung karakter null yang mengakhiri.

Jika lpClass adalah NULL, lpcClass bisa null.

Jika parameter lpClass adalah alamat yang valid, tetapi parameter lpcClass tidak, misalnya, itu ADALAH NULL, maka fungsi mengembalikan ERROR_INVALID_PARAMETER.

lpReserved

Parameter ini dicadangkan dan harus NULL.

[out, optional] lpcSubKeys

Penunjuk ke variabel yang menerima jumlah subkunci yang dimuat oleh kunci yang ditentukan. Parameter ini bisa NULL.

[out, optional] lpcbMaxSubKeyLen

Penunjuk ke variabel yang menerima ukuran subkunci kunci dengan nama terpanjang, dalam karakter ANSI, tidak termasuk karakter null yang mengakhiri. Parameter ini bisa NULL.

[out, optional] lpcbMaxClassLen

Penunjuk ke variabel yang menerima ukuran string terpanjang yang menentukan kelas subkunci, dalam karakter ANSI. Jumlah yang dikembalikan tidak termasuk karakter null yang mengakhiri. Parameter ini bisa NULL.

[out, optional] lpcValues

Penunjuk ke variabel yang menerima jumlah nilai yang terkait dengan kunci. Parameter ini bisa NULL.

[out, optional] lpcbMaxValueNameLen

Penunjuk ke variabel yang menerima ukuran nama nilai terpanjang kunci, dalam karakter ANSI. Ukuran tidak termasuk karakter null yang mengakhiri. Parameter ini bisa NULL.

[out, optional] lpcbMaxValueLen

Penunjuk ke variabel yang menerima ukuran komponen data terpanjang di antara nilai kunci, dalam byte. Parameter ini bisa NULL.

[out, optional] lpcbSecurityDescriptor

Penunjuk ke variabel yang menerima ukuran deskriptor keamanan kunci, dalam byte. Parameter ini bisa NULL.

[out, optional] lpftLastWriteTime

Penunjuk ke struktur FILETIME yang menerima waktu tulis terakhir. Parameter ini bisa NULL.

Fungsi ini mengatur anggota struktur FILETIME untuk menunjukkan terakhir kali kunci atau entri nilainya dimodifikasi.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem.

Jika buffer lpClass terlalu kecil untuk menerima nama kelas, fungsi akan mengembalikan ERROR_MORE_DATA.

Keterangan

Catatan

Pada versi lama Windows, API ini juga diekspos oleh kernel32.dll.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winreg.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll