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;
Member
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, eine für jeden abgerufenen Werteintrag.
EntryCount
Die Anzahl der Einträge im ValueEntries-Array .
ValueBuffer
Ein Zeiger auf einen Puffer, der (vom System) die Daten für alle vom ValueEntries-Array angegebenen Werteinträge empfängt.
BufferLength
Ein Zeiger auf eine Variable, die die Länge des ValueBuffer-Puffers in Bytes enthält.
RequiredBufferLength
Ein Zeiger auf eine Variable, die (vom System) die Anzahl der Bytes empfängt, die erforderlich sind, um die Daten für alle Werteinträge zu enthalten, die das ValueEntries-Array angibt. Dieser Member kann NULL sein.
CallContext
Optionale vom Treiber definierte Kontextinformationen, die die RegistryCallback-Routine des Treibers bereitstellen kann. Dieser Member ist für Windows Vista und höhere Versionen des Windows-Betriebssystems definiert.
ObjectContext
Ein Zeiger auf vom Treiber definierte Kontextinformationen, die der Treiber durch Aufrufen von CmSetCallbackObjectContext einem Registrierungsobjekt zugeordnet hat. Dieser Member ist für Windows Vista und höhere Versionen des Windows-Betriebssystems definiert.
Reserved
Dieses Element ist für die zukünftige Verwendung reserviert. Dieser Member ist für Windows Vista und höhere Versionen des Windows-Betriebssystems definiert.
Hinweise
Das System übergibt diese Struktur an die RegistryCallback-Routine , wenn ein Thread versucht, mehrere Werteinträge für einen Schlüssel gleichzeitig abzurufen, z. B. wenn ein Benutzermodusthread RegQueryMultipleValues aufruft.
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 in ValueBuffer , an dem die Daten für diesen Werteintrag beginnen, und das DataLength-Element 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar unter Microsoft Windows XP und höheren Versionen des Windows-Betriebssystems. |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |