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 |
---|---|
|
No se puede revertir la transacción porque ya se ha confirmado. |
|
La transacción no se ha confirmado, pero su estado actual no permite la reversión. |
|
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 |