Función TmPrepareComplete (wdm.h)
La rutina TmPrepareComplete notifica a KTM que el administrador de recursos que realiza la llamada ha terminado de preparar los datos de una transacción.
Sintaxis
NTSTATUS TmPrepareComplete(
[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 del objeto que proporcionó una llamada anterior a ZwCreateEnlistment, TmCreateEnlistment o ZwOpenEnlistment proporcionada.
[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 |
|---|---|
|
La transacción o su inscripción no está en el estado correcto. Por ejemplo, KTM no envió una notificación de TRANSACTION_NOTIFY_PREPREPARE. |
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 las rutinas TmXxx de KTM en lugar de las rutinas ZwXxx , consulte Uso de rutinas TmXxx.
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 |