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;
Angehörige
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 zum Abrufen von Informationen enthält.
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 KeyValueInformationClassab. 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 gültiger Daten in Bytes im KeyValueInformation- 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 eine RegistryCallback Routine jedes Mal, wenn ein Thread versucht, einen Werteintrag für einen Schlüssel abzufragen, z. B. wenn ein Benutzermodusthread RegQueryValue aufruft oder RegQueryValueEx oder wenn ein Treiber ZwDeleteKeyaufruft.
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) |