Função TmRecoverTransactionManager (wdm.h)

A rotina TmRecoverTransactionManager reconstrói o estado do objeto do gerenciador de transações (incluindo todas as transações, inscrição e gerenciadores de recursos) das informações de recuperação que estão no fluxo de log.

Sintaxe

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

Parâmetros

[in] Tm

Um ponteiro para um objeto do gerenciador de transações. Para obter esse ponteiro, seu componente TPS deve chamar ObReferenceObjectByHandle e fornecer o identificador de objeto que uma chamada anterior para ZwCreateTransactionManager ou ZwOpenTransactionManager forneceu.

[in] TargetVirtualClock

Um ponteiro para um valor de relógio virtual. Esse parâmetro é opcional e pode ser NULL. Para obter mais informações sobre esse parâmetro, consulte a seção Comentários a seguir. Para o Windows Vista, esse parâmetro deve ser NULL.

Retornar valor

TmRecoverTransactionManager retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa rotina pode retornar um dos seguintes valores:

Código de retorno	Descrição
STATUS_NOT_IMPLEMENTED	Para o Windows Vista, o chamador especificou um valor não NULL para o parâmetro TargetVirtualClock .
STATUS_TM_VOLATILE	O objeto do gerenciador de transações especificado não tem um arquivo de log, portanto, a recuperação não está disponível.
STATUS_UNSUCCESSFUL	O objeto do gerenciador de transações especificado está em um estado inesperado.

 

A rotina pode retornar outros valores NTSTATUS.

Comentários

A rotina TmRecoverTransactionManager é uma versão baseada em ponteiro da rotina ZwRecoverTransactionManager .

Chamar TmRecoverTransactionManager com um valor de parâmetro TargetVirtualClock de NULL é funcionalmente equivalente a chamar ZwRecoverTransactionManager. Chamar TmRecoverTransactionManager com um valor de parâmetro TargetVirtualClock não NULL é funcionalmente equivalente a chamar ZwRollforwardTransactionManager.

Para obter mais informações sobre operações de recuperação, consulte Manipulando operações de recuperação.

Para obter informações sobre quando usar rotinas TmXxx da KTM em vez de rotinas ZwXxx , consulte Usando rotinas TmXxx.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores do sistema operacional.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Confira também

ZwRecoverTransactionManager

ZwRollforwardTransactionManager