Función NtRollbackTransaction (wdm.h)

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

Sintaxis

__kernel_entry NTSYSCALLAPI NTSTATUS NtRollbackTransaction(
  [in] HANDLE  TransactionHandle,
  [in] BOOLEAN Wait
);

Parámetros

[in] TransactionHandle

Identificador de un objeto de transacción obtenido por una llamada anterior a ZwCreateTransaction o ZwOpenTransaction. El identificador debe tener TRANSACTION_ROLLBACK acceso al objeto .

[in] Wait

Valor booleano que el autor de la llamada 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 devuelve hasta que se complete la operación de reversión.

Valor devuelto

ZwRollbackTransaction 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_OBJECT_TYPE_MISMATCH	El identificador que especifica el parámetro TransactionHandle no es un identificador para un objeto de transacción.
STATUS_INVALID_HANDLE	Un identificador de objeto no es válido.
STATUS_ACCESS_DENIED	El autor de la llamada no tiene el acceso adecuado al objeto de transacció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

Para obtener más información sobre ZwRollbackTransaction, consulte Control de operaciones de reversión.

NtRollbackEnlistment y ZwRollbackEnlistment son dos versiones de la misma rutina de Servicios del sistema nativo de Windows.

En el caso de las llamadas desde controladores en modo kernel, las versiones NtXxx y ZwXxx de una rutina de Servicios del sistema nativo de Windows se pueden comportar de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services 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, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	HwStorPortProhibitedDIs, PowerIrpDDis

Consulte también

Uso de las versiones Nt y Zw de las rutinas nativas de Servicios del sistema

ZwCommitTransaction

ZwCreateTransaction

ZwOpenTransaction

ZwQueryInformationTransaction