REG_QUERY_KEY_INFORMATION-Struktur (wdm.h)

  • Artikel

Die REG_QUERY_KEY_INFORMATION-Struktur beschreibt die Metadaten, die nach einem Schlüssel abgefragt werden.

Syntax

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;

Member

Object

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

KeyInformationClass

Der KEY_INFORMATION_CLASS Wert, der den Typ der vom System zurückzugebenden 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 von KeyInformationClass ab. 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 Bytes im KeyInformation-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 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 jedes Mal an die RegistryCallback-Routine , wenn ein Thread versucht, die Metadaten für einen Schlüssel abzufragen, z. B. wenn ein Benutzermodusthread RegQueryInfoKey aufruft oder wenn ein Treiber ZwQueryKey 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

ZwQueryKey