Função ZwRecoverTransactionManager (wdm.h)

  • Artigo

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

Sintaxe

NTSYSCALLAPI NTSTATUS ZwRecoverTransactionManager(
  [in] HANDLE TransactionManagerHandle
);

Parâmetros

[in] TransactionManagerHandle

Um identificador para um objeto do gerenciador de transações que foi obtido por uma chamada anterior para ZwCreateTransactionManager ou ZwOpenTransactionManager. O identificador deve ter TRANSACTIONMANAGER_RECOVER acesso ao objeto .

Retornar valor

ZwRecoverTransactionManager 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_OBJECT_TYPE_MISMATCH
 O identificador especificado não é um identificador para um objeto do gerenciador de transações.
STATUS_INVALID_HANDLE
 Um identificador de objeto é inválido.
STATUS_ACCESS_DENIED
 O chamador não tem acesso apropriado ao objeto do gerenciador de transações.
STATUS_TM_VOLATILE
 O objeto do gerenciador de transações é volátil e, portanto, suas transações não podem ser recuperadas.
STATUS_UNSUCCESSFUL
 O objeto do gerenciador de transações não está em um estado que permite a recuperação.
 

A rotina pode retornar outros valores NTSTATUS.

Comentários

A rotina ZwRecoverTransactionManager tenta reconstruir o estado do objeto do gerenciador de transações, incluindo todas as transações, inscrições e gerenciadores de recursos, a partir das informações de recuperação que estão no fluxo de log do objeto, começando na última área de reinicialização que o KTM criou e terminou no final do fluxo.

Para recuperar até um tempo virtual específico, use a rotina ZwRollforwardTransactionManager em vez de ZwRecoverTransactionManager.

Seu componente TPS deve chamar ZwRecoverTransactionManager depois de ter chamado ZwCreateTransactionManager ou ZwOpenTransactionManager.

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

NtRecoverTransactionManager e ZwRecoverTransactionManager são duas versões da mesma rotina dos Serviços do Sistema Nativo do Windows.

Para chamadas de drivers de modo kernel, as versões NtXxx e ZwXxx de uma rotina do Windows Native System Services podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Using Nt and Zw Versions of the Native System Services Routines.

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, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regras de conformidade da DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Confira também

TmRecoverTransactionManager

Usando versões Nt e Zw das rotinas de serviços do sistema nativo

ZwCreateTransactionManager

ZwOpenTransactionManager

ZwRollforwardTransactionManager