Função NtRecoverTransactionManager (wdm.h)
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
__kernel_entry NTSYSCALLAPI NTSTATUS NtRecoverTransactionManager(
[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 |
|---|---|
|
O identificador especificado não é um identificador para um objeto do gerenciador de transações. |
|
Um identificador de objeto é inválido. |
|
O chamador não tem acesso apropriado ao objeto do gerenciador de transações. |
|
O objeto do gerenciador de transações é volátil e, portanto, suas transações não podem ser recuperadas. |
|
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, PowerIrpDDis |
Confira também
Usando versões Nt e Zw das rotinas de serviços do sistema nativo