Función ZwCommitTransaction (wdm.h)

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