Función ZwCommitTransaction (wdm.h)

  • Artículo

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

Sintaxis

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

Parámetros

[in] TransactionHandle

Identificador de un objeto de transacción. El componente recibe este identificador de ZwCreateTransaction o ZwOpenTransaction. El identificador debe tener TRANSACTION_COMMIT acceso al objeto .

[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

ZwCommitTransaction 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 especificado para el parámetro TransactionHandle no es un identificador para un objeto de transacción.
STATUS_INVALID_HANDLE
 El identificador de objeto de transacción especificado no es válido.
STATUS_ACCESS_DENIED

El autor de la llamada no tiene el acceso adecuado al objeto de transacció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

Para obtener más información sobre cómo los clientes de transacciones deben usar la rutina ZwCommitTransaction , vea Creating a Transactional Client.

Para obtener más información sobre las operaciones de confirmación, consulte Control de operaciones de confirmación.

En el caso de las llamadas desde controladores en modo kernel, las versiones NtXxx y ZwXxx de una rutina de Windows Native System Services pueden comportarse 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 de Windows.
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(storport), PowerIrpDDis(wdm)

Consulte también

TmCommitTransaction

Uso de las versiones Nt y Zw de las rutinas nativas de System Services

ZwCreateTransaction

ZwOpenTransaction