REG_QUERY_VALUE_KEY_INFORMATION-Struktur (wdm.h)

Die REG_QUERY_VALUE_KEY_INFORMATION-Struktur enthält Informationen zum Werteintrag eines Registrierungsschlüssels, der abgefragt wird.

Syntax

typedef struct _REG_QUERY_VALUE_KEY_INFORMATION {
  PVOID                       Object;
  PUNICODE_STRING             ValueName;
  KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass;
  PVOID                       KeyValueInformation;
  ULONG                       Length;
  PULONG                      ResultLength;
  PVOID                       CallContext;
  PVOID                       ObjectContext;
  PVOID                       Reserved;
} REG_QUERY_VALUE_KEY_INFORMATION, *PREG_QUERY_VALUE_KEY_INFORMATION;

Member

Object

Ein Zeiger auf das Registrierungsschlüsselobjekt für den Schlüssel, dessen Werteintrag abgefragt wird.

ValueName

Ein Zeiger auf eine UNICODE_STRING-Struktur , die den Namen des Werteintrags enthält, für den Informationen abgerufen werden sollen.

KeyValueInformationClass

Der KEY_VALUE_INFORMATION_CLASS Wert, der den Typ der vom System zurückgegebenen Informationen angibt.

KeyValueInformation

Ein Zeiger auf einen Puffer, der die vom System zurückgegebenen Informationen enthält. Das Format des Puffers hängt vom Wert von KeyValueInformationClass ab. Weitere Informationen finden Sie unter KEY_VALUE_INFORMATION_CLASS.

Length

Die Größe des KeyValueInformation-Puffers in Bytes.

ResultLength

Ein Zeiger auf eine Variable, die (vom System) die Menge an gültigen Daten in Bytes im KeyValueInformation-Puffer empfängt .

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 einem Registrierungsobjekt zugeordnet hat, indem CmSetCallbackObjectContext aufgerufen wird. 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 jedes Mal an eine RegistryCallback-Routine , wenn ein Thread versucht, einen Werteintrag für einen Schlüssel abzufragen, z. B. wenn ein Benutzermodusthread RegQueryValue oder RegQueryValueEx aufruft oder wenn ein Treiber ZwDeleteKey aufruft.

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

RegistryCallback

ZwDeleteKey

ZwQueryValueKey