FltRollbackEnlistment-Funktion (fltkernel.h)

Artikel
02/26/2024

Die FltRollbackEnlistment-Routine führt ein Rollback oder einen Abbruch einer Transaktion im Namen eines Minifiltertreibers durch.

Syntax

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

Parameter

[in] Instance

Undurchsichtiger instance Zeiger für den Aufrufer.

[in] Transaction

Undurchsichtiger Transaktionszeiger für die Transaktion.

[in, optional] TransactionContext

Zeiger 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 Registrierung nicht zulässig. Dies ist ein Fehlercode.

Hinweise

Ein Minifiltertreiber, der in einer Transaktion eingetragen ist, kann FltRollbackEnlistment aufrufen, um die Transaktion zurückzusetzen oder abzubrechen.

Rufen Sie FltEnlistInTransaction auf, um sich in eine Transaktion ein eintragen zu können.

Um einen neuen Transaktionskontext zuzuordnen, rufen Sie FltAllocateContext auf.

Um einen Transaktionskontext abzurufen, rufen Sie FltGetTransactionContext auf.

Um einen Transaktionskontext zu löschen, rufen Sie FltDeleteTransactionContext oder FltDeleteContext auf.

Um einen Transaktionskontext festzulegen, rufen Sie FltSetTransactionContext auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Diese Routine ist unter Windows Vista und höher verfügbar.
Zielplattform	Universell
Header	fltkernel.h (fltkernel.h einschließen)
Bibliothek	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL