Función TmCommitTransaction (wdm.h)

  • Artículo

La rutina TmCommitTransaction inicia una operación de confirmación para una transacción especificada.

Sintaxis

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

Parámetros

[in] Transaction

Puntero a un objeto de transacción. Para obtener este puntero, el componente TPS 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 es TRUE, la llamada devuelve una vez completada la operación de confirmación.

Valor devuelto

TmCommitTransaction 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_SUPERIOR_EXISTS
 El autor de la llamada no puede confirmar la transacción porque existe un administrador de transacciones superior .
STATUS_TRANSACTION_ALREADY_ABORTED
 No se puede confirmar la transacción porque se ha revertido.
STATUS_TRANSACTION_ALREADY_COMMITTED
 La transacción ya está confirmada.
STATUS_TRANSACTION_REQUEST_NOT_VALID
 Ya se ha iniciado la operación de confirmación de esta transacción.
STATUS_PENDING
 Las notificaciones de confirmació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 TmCommitTransaction es una versión basada en punteros de la rutina ZwCommitTransaction .

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

ZwCommitTransaction

ZwCreateTransaction

ZwOpenTransaction