Función TmRecoverTransactionManager (wdm.h)

El TmRecoverTransactionManager rutina reconstruye el estado del objeto del administrador de transacciones (incluidas todas las transacciones, inscritos y administradores de recursos) de la información de recuperación que se encuentra en el flujo de registro.

Sintaxis

NTSTATUS TmRecoverTransactionManager(
  [in] PKTM           Tm,
  [in] PLARGE_INTEGER TargetVirtualClock
);

Parámetros

[in] Tm

Puntero a un objeto de administrador de transacciones . Para obtener este puntero, el componente TPS debe llamar a ObReferenceObjectByHandle y proporcionar el identificador de objeto que se proporcionó una llamada anterior a ZwCreateTransactionManager o ZwOpenTransaction Manager.

[in] TargetVirtualClock

Puntero a un valor de reloj virtual . Este parámetro es opcional y se puede NULL. Para obtener más información sobre este parámetro, vea la siguiente sección Comentarios. Para Windows Vista, este parámetro debe ser null.

Valor devuelto

tmRecoverTransactionManager 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_NOT_IMPLEMENTED	Para Windows Vista, el autor de la llamada especificó un valor null nopara el parámetro targetVirtualClock de .
STATUS_TM_VOLATILE	El objeto de administrador de transacciones especificado no tiene un archivo de registro, por lo que la recuperación no está disponible.
STATUS_UNSUCCESSFUL	El objeto de administrador de transacciones especificado está en un estado inesperado.

 

La rutina puede devolver otros valores NTSTATUS de .

Observaciones

La rutina de TmRecoverTransactionManager es una versión basada en puntero de la rutina ZwRecoverTransactionManager .

Llamar a tmRecoverTransactionManager con un valor de parámetro TargetVirtualC lock de null es funcionalmente equivalente a llamar a ZwRecoverTransactionManager. Llamar a TmRecoverTransactionManager con un valor de parámetroTargetVirtualC lock noNULL es funcionalmente equivalente a llamar a ZwRollforwardTransactionManager.

Para obtener más información sobre las operaciones de recuperación, consulte Control de operaciones de recuperación.

Para obtener información sobre cuándo usar las rutinas de TmXxx de KTM en lugar de ZwXxx rutinas, vea Using TmXxx Routines.

Requisitos

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

Consulte también

ZwRecoverTransactionManager

ZwRollforwardTransactionManager