Funzione FltRollbackComplete (fltkernel.h)

La routine FltRollbackComplete riconosce una notifica di TRANSACTION_NOTIFY_ROLLBACK.

Sintassi

NTSTATUS FLTAPI FltRollbackComplete(
  [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

FltRollbackComplete restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio quanto segue:

Codice restituito Descrizione
STATUS_NOT_FOUND
Il driver minifilter non ha impostato un contesto sulla transazione. Si tratta di un codice di errore.

Commenti

Un driver minifilter incluso in una transazione può ricevere una notifica di TRANSACTION_NOTIFY_ROLLBACK quando la transazione è in fase di rollback o interrotta. Per inviare la notifica al driver minifilter, il gestore filtri chiama la routine TransactionNotificationCallback del driver minifilter. Il driver minifilter riconosce questa notifica in uno dei due modi seguenti:

  • La routine TransactionNotificationCallback del driver minifilter esegue qualsiasi elaborazione necessaria e restituisce STATUS_SUCCESS. In questo caso, il driver minifilter non chiama FltRollbackComplete.
  • La routine TransactionNotificationCallback del driver minifilter pubblica qualsiasi elaborazione necessaria per un thread di lavoro e restituisce STATUS_PENDING. Dopo aver eseguito l'elaborazione in modo asincrono, la routine di lavoro del driver minifilter deve chiamare FltRollbackComplete per indicare che ha completato l'elaborazione. Se la routine di lavoro del driver minifilter non chiama FltRollbackComplete, il rollback delle transazioni o l'operazione di interruzione non può essere completata dalla gestione transazioni kernel.
Per registrare una routine TransactionNotificationCallback, un driver minifilter archivia l'indirizzo di una routine di tipo PFLT_TRANSACTION_NOTIFICATION_CALLBACK nel membro TransactionNotificationCallbackdella strutturaFLT_REGISTRATION che il driver minifilter passa come parametro Di registrazione di FltRegisterFilter.

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 PASSIVE_LEVEL

Vedi anche

FLT_REGISTRATION

FltAllocateContext

FltCommitComplete

FltDeleteContext

FltDeleteTransactionContext

FltEnlistInTransaction

FltGetTransactionContext

FltPrepareComplete

FltPrepareComplete

FltRegisterFilter

FltReleaseContext

FltRollbackEnlistment

FltSetTransactionContext

PFLT_TRANSACTION_NOTIFICATION_CALLBACK