REG_QUERY_KEY_INFORMATION Struktur (wdm.h)

Artikel
07.02.2025

Die REG_QUERY_KEY_INFORMATION Struktur beschreibt die Metadaten, die für einen Schlüssel abgefragt werden sollen.

Syntax

C++

typedef struct _REG_QUERY_KEY_INFORMATION {
  PVOID                 Object;
  KEY_INFORMATION_CLASS KeyInformationClass;
  PVOID                 KeyInformation;
  ULONG                 Length;
  PULONG                ResultLength;
  PVOID                 CallContext;
  PVOID                 ObjectContext;
  PVOID                 Reserved;
} REG_QUERY_KEY_INFORMATION, *PREG_QUERY_KEY_INFORMATION;

Angehörige

Object

Ein Zeiger auf das Registrierungsschlüsselobjekt für den Schlüssel, dessen Metadaten abgefragt werden sollen.

KeyInformationClass

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

KeyInformation

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

Length

Gibt die Größe des KeyInformation- Puffers in Bytes an.

ResultLength

Zeiger auf eine Variable, die (vom System) die Menge gültiger Daten in Byte im KeyInformation Puffer empfängt.

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, die Metadaten für einen Schlüssel abzufragen, z. B. wenn ein Benutzermodusthread RegQueryInfoKey aufruft oder wenn ein Treiber ZwQueryKeyaufruft.

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)