Função CreateResourceManager (ktmw32.h)
Cria um novo objeto RM (Resource Manager) e associa o RM a um TM (gerenciador de transações).
HANDLE CreateResourceManager(
[in, optional] LPSECURITY_ATTRIBUTES lpResourceManagerAttributes,
[in] LPGUID ResourceManagerId,
[in, optional] DWORD CreateOptions,
[in] HANDLE TmHandle,
[in, optional] LPWSTR Description
);
[in, optional] lpResourceManagerAttributes
Um ponteiro para uma estrutura de SECURITY_ATTRIBUTES que contém os atributos de segurança do gerenciador de recursos. Especifique NULL para obter os atributos padrão.
[in] ResourceManagerId
Um ponteiro para o GUID do gerenciador de recursos. Esse parâmetro é necessário e não deve ser NULL.
[in, optional] CreateOptions
Todos os atributos opcionais para o novo RM.
[in] TmHandle
Um identificador para o TM que gerenciará as transações para essa RM.
[in, optional] Description
Uma descrição para este RM.
Se a função for bem-sucedida, o valor retornado será um identificador para o RM.
Se a função falhar, o valor retornado será INVALID_HANDLE_VALUE. Para obter informações de erro estendidas, chame a função
A lista a seguir identifica os possíveis códigos de erro:
Imediatamente após chamar essa função, você deve chamar RecoverResourceManager.
Uma RM é um ponto de extremidade para notificações TM sobre transações em que o RM se inscreveu.
As RMs normalmente são persistentes, o que significa que, após uma falha do sistema, elas devem ser reabertas para executar determinadas operações. RMs voláteis ou transitórias podem ser criadas chamando a função CreateResourceManager e especificando RESOURCE_MANAGER_VOLATILE. RMs voláteis não executam operações de recuperação, mas exigem notificações sobre uma transação.
Você pode criar uma RM volátil em um TM durável, mas não pode criar uma RM durável em um TM volátil.
Requisito | Valor |
---|---|
de cliente com suporte mínimo | Windows Vista |
servidor com suporte mínimo | Windows Server 2008 |
da Plataforma de Destino |
Windows |
cabeçalho | ktmw32.h |
biblioteca | Ktmw32.lib |
de DLL |
Ktmw32.dll |