Função CreateTransactionManager (ktmw32.h)

Cria um novo objeto TM (gerenciador de transações) e retorna um identificador com o acesso especificado.

Sintaxe

HANDLE CreateTransactionManager(
  [in, optional] LPSECURITY_ATTRIBUTES lpTransactionAttributes,
  [in, optional] LPWSTR                LogFileName,
  [in, optional] ULONG                 CreateOptions,
  [in, optional] ULONG                 CommitStrength
);

Parâmetros

[in, optional] lpTransactionAttributes

As ACLs (SECURITY_ATTRIBUTES de transação) do objeto TM.

[in, optional] LogFileName

O nome do fluxo do arquivo de log. Se o fluxo não existir no log, ele será criado. Para criar um TM volátil, esse parâmetro deve ser NULL e CreateOptions deve especificar TRANSACTION_MANAGER_VOLATILE, esse gerenciador de transações é considerado volátil.

[in, optional] CreateOptions

Todos os atributos opcionais para o novo TM.

[in, optional] CommitStrength

Reservado; especificar zero.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será um identificador para o gerenciador de transações.

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

Se o gerenciador de transações for volátil, todos os gerenciadores de recursos também deverão ser voláteis.

Você deve chamar RecoverTransactionManager depois de criar uma TM para que o TM funcione corretamente.

Requisitos

Consulte também

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

OpenTransactionManager

RecoverTransactionManager

SECURITY_ATTRIBUTES