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)

Weitere Informationen

CmSetCallbackObjectContext

KEY_VALUE_ENTRY

RegistryCallback