Funzione FltRollbackEnlistment (fltkernel.h)

Articolo
08/07/2023

La routine FltRollbackEnlistment esegue il rollback o interrompe una transazione per conto di un driver minifilter.

Sintassi

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

Parametri

[in] Instance

Puntatore istanza opaca per il chiamante.

[in] Transaction

Puntatore delle transazioni opaco per la transazione.

[in, optional] TransactionContext

Puntatore al contesto delle transazioni del driver minifilter.

Valore restituito

FltRollbackEnlistment restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_NOT_FOUND	Il driver minifilter non ha impostato un contesto sulla transazione. Si tratta di un codice di errore.
STATUS_TRANSACTION_REQUEST_NOT_VALID	La richiesta di rollback delle transazioni non è consentita per l'inserimento. Si tratta di un codice di errore.

Commenti

Un driver minifilter incluso in una transazione può chiamare FltRollbackEnlistment per eseguire il rollback o interrompere la transazione.

Per eseguire l'inserimento in una transazione, chiamare FltEnlistInTransaction.

Per allocare un nuovo contesto di transazione, chiamare FltAllocateContext.

Per recuperare un contesto di transazione, chiamare FltGetTransactionContext.

Per eliminare un contesto di transazione, chiamare FltDeleteTransactionContext o FltDeleteContext.

Per impostare un contesto di transazione, chiamare FltSetTransactionContext.

Requisiti

Requisito	Valore
Client minimo supportato	Questa routine è disponibile in Windows Vista e versioni successive.
Piattaforma di destinazione	Universale
Intestazione	fltkernel.h (includere Fltkernel.h)
Libreria	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL