struktur REG_QUERY_KEY_INFORMATION (wdm.h)

  • Artikel

Struktur REG_QUERY_KEY_INFORMATION menjelaskan metadata yang akan dikueri untuk kunci.

Sintaks

typedef struct _REG_QUERY_KEY_INFORMATION {
  PVOID                 Object;
  KEY_INFORMATION_CLASS KeyInformationClass;
  PVOID                 KeyInformation;
  ULONG                 Length;
  PULONG                ResultLength;
  PVOID                 CallContext;
  PVOID                 ObjectContext;
  PVOID                 Reserved;
} REG_QUERY_KEY_INFORMATION, *PREG_QUERY_KEY_INFORMATION;

Anggota

Object

Penunjuk ke objek kunci registri untuk kunci yang metadatanya akan dikueri.

KeyInformationClass

Nilai KEY_INFORMATION_CLASS yang menunjukkan jenis informasi yang akan dikembalikan oleh sistem.

KeyInformation

Penunjuk ke buffer yang berisi informasi yang akan dikembalikan oleh sistem. Format buffer tergantung pada nilai KeyInformationClass. Untuk informasi selengkapnya, lihat KEY_INFORMATION_CLASS.

Length

Menentukan ukuran, dalam byte, dari buffer KeyInformation .

ResultLength

Penunjuk ke variabel yang menerima (dari sistem) jumlah data yang valid, dalam byte, di buffer KeyInformation .

CallContext

Informasi konteks opsional yang ditentukan driver yang dapat disediakan oleh rutinitas RegistryCallback driver. Anggota ini didefinisikan untuk Windows Vista dan versi yang lebih baru dari sistem operasi Windows.

ObjectContext

Penunjuk ke informasi konteks yang ditentukan driver yang telah dikaitkan dengan objek registri dengan memanggil CmSetCallbackObjectContext. Anggota ini didefinisikan untuk Windows Vista dan versi yang lebih baru dari sistem operasi Windows.

Reserved

Anggota ini dicadangkan untuk digunakan di masa mendatang. Anggota ini didefinisikan untuk Windows Vista dan versi yang lebih baru dari sistem operasi Windows.

Keterangan

Sistem meneruskan struktur ini ke rutinitas RegistryCallback setiap kali utas mencoba mengkueri metadata untuk kunci—misalnya, saat utas mode pengguna memanggil RegQueryInfoKey atau saat driver memanggil ZwQueryKey.

Untuk informasi selengkapnya tentang operasi pemfilteran registri, lihat Memfilter Panggilan Registri.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Microsoft Windows XP dan versi sistem operasi Windows yang lebih baru.
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)

Lihat juga

CmSetCallbackObjectContext

RegistryCallback

ZwQueryKey