Função ZwRecoverResourceManager (wdm.h)

Artigo
03/01/2024

A rotina ZwRecoverResourceManager tenta recuperar a transação associada a cada inscrição de um objeto especificado do gerenciador de recursos.

Sintaxe

NTSYSCALLAPI NTSTATUS ZwRecoverResourceManager(
  [in] HANDLE ResourceManagerHandle
);

Parâmetros

[in] ResourceManagerHandle

Um identificador para um objeto do gerenciador de recursos que foi obtido por uma chamada anterior para ZwCreateResourceManager ou ZwOpenResourceManager. O identificador deve ter RESOURCEMANAGER_RECOVER acesso ao objeto .

Retornar valor

ZwRecoverResourceManager 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 recursos.
STATUS_INVALID_HANDLE	Um identificador de objeto é inválido.
STATUS_TRANSACTIONMANAGER_NOT_ONLINE	O gerenciador de transações associado ao gerenciador de recursos especificado não está disponível.
STATUS_ACCESS_DENIED	O chamador não tem acesso apropriado ao objeto do gerenciador de recursos.

A rotina pode retornar outros valores NTSTATUS.

Comentários

Quando um gerenciador de recursos chama ZwRecoverResourceManager, a KTM envia uma notificação de TRANSACTION_NOTIFY_RECOVER ao gerenciador de recursos para cada um dos alistamentos do gerenciador de recursos. (Se o alistamento for um alistamento superior, a KTM enviará TRANSACTION_NOTIFY_RECOVER_QUERY em vez de TRANSACTION_NOTIFY_RECOVER.)

A notificação final que o KTM envia ao gerenciador de recursos é TRANSACTION_NOTIFY_LAST_RECOVER.

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

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

Para chamadas de drivers no modo kernel, as versões NtXxx e ZwXxx de uma rotina dos Serviços do 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 dos Serviços de Sistema Nativo.

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 (inclua Wdm.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL