REG_POST_OPERATION_INFORMATION-Struktur (wdm.h)

  • Artikel

Die REG_POST_OPERATION_INFORMATION-Struktur enthält Informationen zu einem abgeschlossenen Registrierungsvorgang, den eine RegistryCallback-Routine verwenden kann.

Syntax

typedef struct _REG_POST_OPERATION_INFORMATION {
  PVOID    Object;
  NTSTATUS Status;
  PVOID    PreInformation;
  NTSTATUS ReturnStatus;
  PVOID    CallContext;
  PVOID    ObjectContext;
  PVOID    Reserved;
} REG_POST_OPERATION_INFORMATION, *PREG_POST_OPERATION_INFORMATION;

Member

Object

Ein Zeiger auf das Registrierungsschlüsselobjekt, für das der Vorgang abgeschlossen wurde. Dieser Member ist nur gültig, wenn das Statuselement der Struktur auf STATUS_SUCCESS festgelegt ist. Weitere Informationen finden Sie unter Ungültige Schlüsselobjektzeiger in Registrierungsbenachrichtigungen.

Status

Der NTSTATUS-typisierte Wert, den das System für den Registrierungsvorgang zurückgibt.

PreInformation

Ein Zeiger auf die Struktur, die Vorverarbeitungsinformationen für den abgeschlossenen Registrierungsvorgang enthält. Wenn die RegistryCallback-Routine beispielsweise einen RegNtPostQueryValueKey-Vorgang verarbeitet, verweist das PreInformation-Element auf eine REG_QUERY_VALUE_KEY_INFORMATION Struktur. Dieser Member ist für Windows Vista und höhere Versionen des Windows-Betriebssystems definiert.

ReturnStatus

Ein vom Treiber bereitgestellter NTSTATUS-typisierter Wert. Wenn die RegistryCallback-Routine des Treibers STATUS_CALLBACK_BYPASS zurückgibt, verwendet das Betriebssystem den Wert des ReturnStatus-Members als status, den es an den Thread zurückgibt, der den Registrierungsvorgang initiiert hat. (In solchen Fällen kopiert das Betriebssystem auch den Wert des ReturnStatus-Members in das Status-Element .) Andernfalls wird dieser Member ignoriert. Dieser Member ist für Windows Vista und höhere Versionen des Windows-Betriebssystems definiert.

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

Weitere Informationen zum Behandeln von Postbenachrichtigungen finden Sie unter Behandeln von Benachrichtigungen.

Weitere Informationen zu Registrierungsfiltervorgängen finden Sie unter Filtern von Registrierungsaufrufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar unter Microsoft Windows Server 2003 und höheren Versionen des Windows-Betriebssystems, aber einige Strukturmitglieder sind nur für Windows Vista und höhere Versionen verfügbar.
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)

Weitere Informationen

CmSetCallbackObjectContext

REG_QUERY_VALUE_KEY_INFORMATION

RegistryCallback