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

A SECURITY_ATTRIBUTES de transação (ACLs) para o 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

Reservados; especifique zero.

Retornar valor

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

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 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 um TM para que o TM funcione corretamente.

Requisitos

Confira também

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

OpenTransactionManager

RecoverTransactionManager

SECURITY_ATTRIBUTES