REG_SET_VALUE_KEY_INFORMATION-Struktur (wdm.h)

Die REG_SET_VALUE_KEY_INFORMATION-Struktur beschreibt eine neue Einstellung für den Werteintrag eines Registrierungsschlüssels.

Syntax

typedef struct _REG_SET_VALUE_KEY_INFORMATION {
  PVOID           Object;
  PUNICODE_STRING ValueName;
  ULONG           TitleIndex;
  ULONG           Type;
  PVOID           Data;
  ULONG           DataSize;
  PVOID           CallContext;
  PVOID           ObjectContext;
  PVOID           Reserved;
} REG_SET_VALUE_KEY_INFORMATION, *PREG_SET_VALUE_KEY_INFORMATION;

Member

Object

Ein Zeiger auf das Registrierungsschlüsselobjekt für den Schlüssel, dessen Werteintrag im Moment geändert werden soll.

ValueName

Ein Zeiger auf eine UNICODE_STRING-Struktur , die den Namen des Werteintrags enthält, der geändert werden soll.

TitleIndex

Ist für das System reserviert. Treiber sollten diesen Member ignorieren.

Type

Der Datentyp, der geschrieben werden soll. Weitere Informationen zu den möglichen Werten für diesen Member finden Sie im Type-Parameter von ZwSetValueKey.

Data

Ein Zeiger auf einen Puffer, der die Daten enthält, die geschrieben werden sollen. Das Format des Puffers hängt vom Wert von Type ab. Weitere Informationen finden Sie unter ZwSetValueKey.

DataSize

Die Größe des Datenpuffers in Bytes.

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 an eine RegistryCallback-Routine , wenn ein Thread versucht, einen Werteintrag für einen Schlüssel festzulegen, z. B. wenn ein Benutzermodusthread RegSetValue oder RegSetValueEx aufruft oder wenn ein Treiber ZwSetValueKey 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

ZwSetValueKey