Función FltRollbackEnlistment (fltkernel.h)

Artículo
02/06/2025

El FltRollbackEnlistment rutina revierte o anula una transacción en nombre de un controlador de minifiltro.

Sintaxis

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

Parámetros

[in] Instance

Puntero de instancia opaco para el autor de la llamada.

[in] Transaction

Puntero de transacción opaco para la transacción.

[in, optional] TransactionContext

Puntero al contexto de transacción del controlador de minifiltro.

Valor devuelto

fltRollbackEnlistment devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como uno de los siguientes:

Código devuelto	Descripción
STATUS_NOT_FOUND	El controlador de minifiltro no estableció un contexto en la transacción. Se trata de un código de error.
STATUS_TRANSACTION_REQUEST_NOT_VALID	No se permite la solicitud de reversión de transacciones para esta inscripción. Se trata de un código de error.

Observaciones

Un controlador de minifiltro que está inscrito en una transacción puede llamar a FltRollbackEnlistment para revertir o anular la transacción.

Para inscribirse en una transacción, llame a FltEnlistInTransaction.

Para asignar un nuevo contexto de transacción, llame a FltAllocateContext.

Para recuperar un contexto de transacción, llame a FltGetTransactionContext.

Para eliminar un contexto de transacción, llame a FltDeleteTransactionContext o FltDeleteContext.

Para establecer un contexto de transacción, llame a FltSetTransactionContext.

Requisitos

Requisito	Valor
cliente mínimo admitido	Esta rutina está disponible en Windows Vista y versiones posteriores.
de la plataforma de destino de	Universal
encabezado de	fltkernel.h (incluya Fltkernel.h)
biblioteca de	FltMgr.lib
DLL de	Fltmgr.sys
irQL	<= APC_LEVEL