Función FltRollbackEnlistment (fltkernel.h)

Artículo
08/07/2023

La rutina FltRollbackEnlistment 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 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.

Comentarios

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	Value
Cliente mínimo compatible	Esta rutina está disponible en Windows Vista y versiones posteriores.
Plataforma de destino	Universal
Encabezado	fltkernel.h (incluya Fltkernel.h)
Library	FltMgr.lib
Archivo DLL	Fltmgr.sys
IRQL	<= APC_LEVEL