Função TmRecoverTransactionManager (wdm.h)

Artigo
07/16/2024

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, o componente TPS deve chamar ObReferenceObjectByHandle e fornecer o identificador de objeto que uma chamada anterior para ZwCreateTransactionManager ou ZwOpenTransactionManager.

[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.

Valor de retorno

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

Código de retorno	Descrição
STATUS_NOT_IMPLEMENTED	Para o Windows Vista, o chamador especificou um valor de NULL nãopara 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 .

Observações

A rotina de TmRecoverTransactionManager é uma versão baseada em ponteiro da rotina de 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 deNULL targetVirtualClock é funcionalmente equivalente a chamar ZwRollforwardTransactionManager.

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

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

Requisitos

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

Consulte também

ZwRecoverTransactionManager

ZwRollforwardTransactionManager

Compartilhar via