Fungsi RegQueryInfoKeyA (winreg.h)
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 |