struktur REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION (wdm.h)

Struktur REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION menjelaskan beberapa entri nilai yang sedang diambil untuk kunci.

Sintaks

typedef struct _REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION {
  PVOID            Object;
  PKEY_VALUE_ENTRY ValueEntries;
  ULONG            EntryCount;
  PVOID            ValueBuffer;
  PULONG           BufferLength;
  PULONG           RequiredBufferLength;
  PVOID            CallContext;
  PVOID            ObjectContext;
  PVOID            Reserved;
} REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION, *PREG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION;

Anggota

Object

Penunjuk ke objek kunci registri untuk kunci yang entri nilainya sedang diambil.

ValueEntries

Penunjuk ke array struktur KEY_VALUE_ENTRY , satu untuk setiap entri nilai yang diambil.

EntryCount

Jumlah entri dalam array ValueEntries .

ValueBuffer

Penunjuk ke buffer yang menerima (dari sistem) data untuk semua entri nilai yang ditentukan oleh array ValueEntries .

BufferLength

Penunjuk ke variabel yang berisi panjang, dalam byte, dari buffer ValueBuffer .

RequiredBufferLength

Penunjuk ke variabel yang menerima (dari sistem) jumlah byte yang diperlukan untuk menyimpan data untuk semua entri nilai yang ditentukan array ValueEntries . Anggota ini bisa NULL.

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 mengambil beberapa entri nilai untuk kunci sekaligus—misalnya, ketika utas mode pengguna memanggil RegQueryMultipleValues.

Setiap struktur KEY_VALUE_ENTRY dalam array ValueEntries menjelaskan satu entri nilai dalam buffer ValueBuffer . Secara khusus, anggota DataOffsetdari KEY_VALUE_ENTRY berisi offset dalam ValueBuffer di mana data untuk entri nilai tersebut dimulai, dan anggota DataLength berisi panjang, dalam byte, dari data untuk entri nilai tersebut.

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 yang lebih baru dari sistem operasi Windows.
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)

Lihat juga

CmSetCallbackObjectContext

KEY_VALUE_ENTRY

RegistryCallback