Función TmRollbackTransaction (wdm.h)

La rutina TmRollbackTransaction inicia una operación de reversión para una transacción especificada.

Sintaxis

NTSTATUS TmRollbackTransaction(
  [in] PKTRANSACTION Transaction,
  [in] BOOLEAN       Wait
);

Parámetros

[in] Transaction

Puntero a un objeto de transacción. Para obtener este puntero, el componente debe llamar a ObReferenceObjectByHandle y proporcionar el identificador del objeto que proporcionó una llamada anterior a ZwCreateTransaction o ZwOpenTransaction .

[in] Wait

Valor booleano que el llamador establece en TRUE para la operación sincrónica o FALSE para la operación asincrónica. Si este parámetro se establece en TRUE, la llamada no se devuelve hasta que se completa la operación de reversión.

Valor devuelto

TmRollbackTransaction devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta rutina podría devolver uno de los siguientes valores:

Código devuelto	Descripción
STATUS_TRANSACTION_ALREADY_COMMITTED	No se puede revertir la transacción porque ya se ha confirmado.
STATUS_TRANSACTION_REQUEST_NOT_VALID	La transacción no se ha confirmado, pero su estado actual no permite la reversión.
STATUS_PENDING	Las notificaciones de reversión se han puesto en cola en los administradores de recursos y el autor de la llamada especificó FALSE para el parámetro Wait .

 

La rutina podría devolver otros valores NTSTATUS.

Comentarios

La rutina TmRollbackTransaction es una versión basada en punteros de la rutina ZwRollbackTransaction .

Para obtener información sobre cuándo usar rutinas TmXxx de KTM en lugar de rutinas ZwXxx , vea Using TmXxx Routines.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores del sistema operativo.
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Consulte también

ObReferenceObjectByHandle

ZwCreateTransaction

ZwOpenTransaction

ZwRollbackTransaction