Función TmPrepareComplete (wdm.h)

Artículo
08/08/2023

La rutina TmPrepareComplete notifica a KTM que el administrador de recursos que realiza la llamada ha finalizado la preparación preliminar de los datos de una transacción.

Sintaxis

NTSTATUS TmPrePrepareComplete(
  [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

TmPrepareComplete 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_NOT_REQUESTED	La transacción o su inscripción no están en el estado correcto. Por ejemplo, KTM no envió una notificación TRANSACTION_NOTIFY_PREPARE.

La rutina podría devolver otros valores NTSTATUS.

Comentarios

La rutina TmPrepareComplete es una versión basada en puntero de la rutina ZwPrepareComplete .

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