Fungsi RegQueryInfoKeyW (winreg.h)

Mengambil informasi tentang kunci registri yang ditentukan.

Sintaksis

LSTATUS RegQueryInfoKeyW(
  [in]                HKEY      hKey,
  [out, optional]     LPWSTR    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 RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyEx, atau fungsi RegOpenKeyTransacted. Ini juga bisa menjadi salah satu kunci berikut yang telah ditentukan sebelumnya:

   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 dapat null.

[in, out, optional] lpcchClass

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

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

Jika lpClass NULL, lpcClass dapat NULL.

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

lpReserved

Parameter ini dicadangkan dan harus NULL.

[out, optional] lpcSubKeys

Pointer ke variabel yang menerima jumlah subkunci yang dimuat oleh kunci yang ditentukan. Parameter ini dapat null.

[out, optional] lpcbMaxSubKeyLen

Penunjuk ke variabel yang menerima ukuran subkunci kunci dengan nama terpanjang, dalam karakter Unicode, tidak termasuk karakter null yang dihentikan. Parameter ini dapat null.

[out, optional] lpcbMaxClassLen

Penunjuk ke variabel yang menerima ukuran string terpanjang yang menentukan kelas subkunci, dalam karakter Unicode. Jumlah yang dikembalikan tidak termasuk karakter null dihentikan. Parameter ini dapat null.

[out, optional] lpcValues

Penunjuk ke variabel yang menerima jumlah nilai yang terkait dengan kunci. Parameter ini dapat null.

[out, optional] lpcbMaxValueNameLen

Pointer ke variabel yang menerima ukuran nama nilai terpanjang kunci, dalam karakter Unicode. Ukuran tidak termasuk karakter null yang dihentikan. Parameter ini dapat null.

[out, optional] lpcbMaxValueLen

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

[out, optional] lpcbSecurityDescriptor

Penunjuk ke variabel yang menerima ukuran deskriptor keamanan kunci, dalam byte. Parameter ini dapat null.

[out, optional] lpftLastWriteTime

Penunjuk ke struktur FILETIME yang menerima waktu tulis terakhir. Parameter ini dapat null.

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

Mengembalikan nilai

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.

Komentar

Persyaratan

Lihat juga

FILETIME

regDeleteKey

RegEnumKeyEx

RegEnumValue

RegQueryValueEx

Fungsi Registri

Gambaran Umum Registri