Función TmCommitEnlistment (wdm.h)

Artículo
02/27/2024

La rutina TmCommitEnlistment inicia la operación de confirmación para una transacción de inscripción especificada.

Sintaxis

NTSTATUS TmCommitEnlistment(
  [in] PKENLISTMENT   Enlistment,
  [in] PLARGE_INTEGER TmVirtualClock
);

Parámetros

[in] Enlistment

Puntero a un objeto de inscripción. El componente puede recibir este puntero como entrada en una rutina de devolución de llamada ResourceManagerNotification . Como alternativa, el componente puede llamar a ObReferenceObjectByHandle y proporcionar el identificador de objeto que proporciona una llamada anterior a ZwCreateEnlistment, TmCreateEnlistment o ZwOpenEnlistment .

[in] TmVirtualClock

Puntero a un valor de reloj virtual. Este parámetro es opcional y puede ser NULL.

Valor devuelto

TmCommitEnlistment 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_ENLISTMENT_NOT_SUPERIOR	El autor de la llamada no es un administrador de transacciones superior para la inscripción.
STATUS_TRANSACTION_RESPONSE_NOT_ENLISTED	El autor de la llamada no se registró para recibir notificaciones TRANSACTION_NOTIFY_COMMIT_COMPLETE.
STATUS_TRANSACTION_REQUEST_NOT_VALID	La transacción de la inscripción no está en un estado que le permita confirmarse.
STATUS_TRANSACTION_NOT_ACTIVE	Ya se ha iniciado la operación de confirmación de esta transacción.
STATUS_TRANSACTION_ALREADY_ABORTED	No se puede confirmar la transacción porque se ha revertido.

La rutina podría devolver otros valores NTSTATUS.

Comentarios

La rutina TmCommitEnlistment es una versión basada en puntero de la rutina ZwCommitEnlistment .

Solo los administradores de transacciones superiores pueden llamar a TmCommitEnlistment.

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