Função CreateResourceManager (ktmw32.h)

Artigo
11/20/2024

Cria um novo objeto RM (Resource Manager) 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 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.

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

[in] TmHandle

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

[in, optional] Description

Uma descrição para este RM.

Valor de retorno

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 GetLastError.

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

Observações

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.

Requisitos

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

Consulte também

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

OpenResourceManager

SECURITY_ATTRIBUTES

SetResourceManagerCompletionPort

Compartilhar via