Função FltRollbackEnlistment (fltkernel.h)

Artigo
02/26/2024

A rotina FltRollbackEnlistment reverte ou anula uma transação em nome de um driver de minifiltro.

Sintaxe

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

Parâmetros

[in] Instance

Ponteiro de instância opaco para o chamador.

[in] Transaction

Ponteiro de transação opaco para a transação.

[in, optional] TransactionContext

Ponteiro para o contexto de transação do driver de minifiltro.

Retornar valor

FltRollbackEnlistment retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes:

Código de retorno	Descrição
STATUS_NOT_FOUND	O driver de minifiltro não definiu um contexto na transação. Este é um código de erro.
STATUS_TRANSACTION_REQUEST_NOT_VALID	A solicitação de reversão de transação não é permitida para essa inscrição. Este é um código de erro.

Comentários

Um driver de minifiltro que está inscrito em uma transação pode chamar FltRollbackEnlistment para reverter ou anular a transação.

Para se inscrever em uma transação, chame FltEnlistInTransaction.

Para alocar um novo contexto de transação, chame FltAllocateContext.

Para recuperar um contexto de transação, chame FltGetTransactionContext.

Para excluir um contexto de transação, chame FltDeleteTransactionContext ou FltDeleteContext.

Para definir um contexto de transação, chame FltSetTransactionContext.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Essa rotina está disponível no Windows Vista e posterior.
Plataforma de Destino	Universal
Cabeçalho	fltkernel.h (inclua Fltkernel.h)
Biblioteca	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL