Función NtCommitTransaction (wdm.h)

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

Sintaxis

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

Parámetros

[in] TransactionHandle

Identificador de un objeto de transacción de . El componente recibe este identificador de ZwCreateTransaction o ZwOpenTransaction. El identificador debe tener TRANSACTION_COMMIT 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 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	La operación de confirmación de esta transacción ya se ha iniciado.
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 puede devolver otros valores NTSTATUS de .

Observaciones

Para obtener más información sobre cómo los clientes de transacción deben usar la rutina de de ZwCommitTransaction, vea Creación de un cliente transaccional.

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 NtXxx y Zwversiones de Xxx de una rutina de Servicios del sistema nativo de Windows 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 de NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Windows Vista y versiones posteriores de Windows.
de la plataforma de destino de	Universal
encabezado de	wdm.h (include Wdm.h, Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	PASSIVE_LEVEL
reglas de cumplimiento de DDI	HwStorPortProhibitedDIs, PowerIrpDDis

Consulte también

tmCommitTransaction de

usar versiones Nt y Zw de las rutinas de servicios del sistema nativo

ZwCreateTransaction

ZwOpenTransaction