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) |