Função NtRecoverResourceManager (wdm.h)
A rotina de ZwRecoverResourceManager tenta recuperar a transação associada a cada inscrição de um objeto resource manager especificado.
Sintaxe
__kernel_entry NTSYSCALLAPI NTSTATUS NtRecoverResourceManager(
[in] HANDLE ResourceManagerHandle
);
Parâmetros
[in] ResourceManagerHandle
Um identificador para um objeto do gerenciador de recursos obtido por uma chamada anterior para ZwCreateResourceManager ou ZwOpenResourceManager. O identificador deve ter acesso RESOURCEMANAGER_RECOVER ao objeto.
Valor de retorno
ZwRecoverResourceManager 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 |
|---|---|
|
O identificador especificado não é um identificador para um objeto do gerenciador de recursos. |
|
Um identificador de objeto é inválido. |
|
O gerenciador de transações associado ao gerenciador de recursos especificado não está disponível. |
|
O chamador não tem acesso apropriado ao objeto do gerenciador de recursos. |
A rotina pode retornar outros valores NTSTATUS .
Observações
Quando um gerenciador de recursos chama ZwRecoverResourceManager, a KTM envia uma notificação TRANSACTION_NOTIFY_RECOVER ao gerenciador de recursos para cada uma das inscrição do gerenciador de recursos. (Se a inscrição for superior, a KTM enviará TRANSACTION_NOTIFY_RECOVER_QUERY em vez de TRANSACTION_NOTIFY_RECOVER.)
A notificação final enviada pela KTM ao gerenciador de recursos é TRANSACTION_NOTIFY_LAST_RECOVER.
Para obter mais informações sobre ZwRecoverResourceManager, consulte Handling Recovery Operations.
NtRecoverResourceManager e ZwRecoverResourceManager são duas versões da mesma rotina dos Serviços de Sistema Nativo do Windows.
Para chamadas de drivers no modo kernel, as versões NtXxx e Zwxxx versões de uma rotina dos Serviços de Sistema Nativo do Windows 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 Usando versões Nt e Zw das rotinas de serviços do sistema nativo.
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, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
Consulte também
usando versões Nt e Zw das rotinas de serviços do sistema nativo