FltRollbackEnlistment-Funktion (fltkernel.h)

Artikel
02/06/2025

Die FltRollbackEnlistment Routine rollt eine Transaktion im Auftrag eines Minifiltertreibers zurück oder bricht sie ab.

Syntax

NTSTATUS FLTAPI FltRollbackEnlistment(
  [in]           PFLT_INSTANCE Instance,
  [in]           PKTRANSACTION Transaction,
  [in, optional] PFLT_CONTEXT  TransactionContext
);

Parameter

[in] Instance

Undurchsichtiger Instanzzeiger für den Aufrufer.

[in] Transaction

Undurchsichtiger Transaktionszeiger für die Transaktion.

[in, optional] TransactionContext

Zeigen Sie auf den Transaktionskontext des Minifiltertreibers.

Rückgabewert

FltRollbackEnlistment gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert zurück, z. B. einen der folgenden:

Rückgabecode	Beschreibung
STATUS_NOT_FOUND	Der Minifiltertreiber hat keinen Kontext für die Transaktion festgelegt. Dies ist ein Fehlercode.
STATUS_TRANSACTION_REQUEST_NOT_VALID	Die Transaktionsrollbackanforderung ist für diese Liste nicht zulässig. Dies ist ein Fehlercode.

Bemerkungen

Ein Minifiltertreiber, der in einer Transaktion aufgelistet ist, kann FltRollbackEnlistment- aufrufen, um die Transaktion rückgängig zu machen oder abzubrechen.

Zum Auflisten in einer Transaktion rufen Sie FltEnlistInTransactionauf.

Rufen Sie FltAllocateContextauf, um einen neuen Transaktionskontext zuzuweisen.

Rufen Sie zum Abrufen eines Transaktionskontexts FltGetTransactionContextauf.

Rufen Sie zum Löschen eines Transaktionskontexts FltDeleteTransactionContext oder FltDeleteContext-auf.

Rufen Sie FltSetTransactionContextauf, um einen Transaktionskontext festzulegen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Diese Routine ist unter Windows Vista und höher verfügbar.
Zielplattform-	Universal
Header-	fltkernel.h (include Fltkernel.h)
Library	FltMgr.lib
DLL-	Fltmgr.sys
IRQL-	<= APC_LEVEL