Função CreateResourceManager (ktmw32.h)

Cria um novo objeto RM (gerenciador de recursos) e associa o RM a um TM (gerenciador de transações).

Sintaxe

HANDLE CreateResourceManager(
  [in, optional] LPSECURITY_ATTRIBUTES lpResourceManagerAttributes,
  [in]           LPGUID                ResourceManagerId,
  [in, optional] DWORD                 CreateOptions,
  [in]           HANDLE                TmHandle,
  [in, optional] LPWSTR                Description
);

Parâmetros

[in, optional] lpResourceManagerAttributes

Um ponteiro para uma estrutura 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.

Valor	Significado
RESOURCE_MANAGER_VOLATILE	Indica que a RM é volátil e não executa a recuperação.

[in] TmHandle

Um identificador para o TM que gerenciará as transações para esse RM.

[in, optional] Description

Uma descrição para esta RM.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador para o RM.

Se houver falha na função, o valor de retorno será INVALID_HANDLE_VALUE. Para obter informações de erro estendidas, chame a função GetLastError.

A lista a seguir identifica os possíveis códigos de erro:

Comentários

Imediatamente após chamar essa função, você deve chamar RecoverResourceManager.

Um RM é um ponto de extremidade para notificações de TM sobre transações nas quais a 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. As 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.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	ktmw32.h
Biblioteca	Ktmw32.lib
DLL	Ktmw32.dll

Confira também

Funções do Gerenciador de Transações do Kernel

OpenResourceManager

SECURITY_ATTRIBUTES

SetResourceManagerCompletionPort