REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION Struktur (wdm.h)
Die REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION Struktur beschreibt die mehrfachen Werteinträge, die für einen Schlüssel abgerufen werden.
Syntax
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;
Angehörige
Object
Ein Zeiger auf das Registrierungsschlüsselobjekt für den Schlüssel, dessen Werteinträge abgerufen werden.
ValueEntries
Ein Zeiger auf ein Array von KEY_VALUE_ENTRY Strukturen, eines für jeden abgerufenen Werteintrag.
EntryCount
Die Anzahl der Einträge im ValueEntries Array.
ValueBuffer
Ein Zeiger auf einen Puffer, der die Daten für alle Vom ValueEntries Array angegebenen Werteinträge empfängt (vom System).
BufferLength
Ein Zeiger auf eine Variable, die die Länge des ValueBuffer- Puffers in Byte enthält.
RequiredBufferLength
Ein Zeiger auf eine Variable, die (vom System) die Anzahl der Bytes empfängt, die zum Speichern der Daten für alle Werteinträge erforderlich sind, die vom ValueEntries Array angegeben werden. Dieses Element kann NULL-sein.
CallContext
Optionale treiberdefinierte Kontextinformationen, die die RegistryCallback Routine des Treibers bereitstellen können. Dieses Element ist für Windows Vista und höhere Versionen des Windows-Betriebssystems definiert.
ObjectContext
Ein Zeiger auf treiberdefinierte Kontextinformationen, die der Treiber einem Registrierungsobjekt zugeordnet hat, indem CmSetCallbackObjectContextaufgerufen wird. Dieses Element ist für Windows Vista und höhere Versionen des Windows-Betriebssystems definiert.
Reserved
Dieses Mitglied ist für die zukünftige Verwendung reserviert. Dieses Element ist für Windows Vista und höhere Versionen des Windows-Betriebssystems definiert.
Bemerkungen
Das System übergibt diese Struktur an die RegistryCallback- Routine jedes Mal, wenn ein Thread versucht, mehrere Werteinträge für einen Schlüssel gleichzeitig abzurufen , z. B. wenn ein Benutzermodusthread RegQueryMultipleValuesaufruft.
Jede KEY_VALUE_ENTRY Struktur im ValueEntries Array beschreibt einen Werteintrag im ValueBuffer Puffer. Insbesondere enthält das DataOffset Element von KEY_VALUE_ENTRY den Offset innerhalb ValueBuffer, in dem die Daten für diesen Werteintrag beginnen, und das DataLength Member enthält die Länge der Daten für diesen Werteintrag in Byte.
Weitere Informationen zu Registrierungsfiltervorgängen finden Sie unter Filtern von Registrierungsaufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar unter Microsoft Windows XP und höheren Versionen des Windows-Betriebssystems. |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |