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.
| Valor | Significado |
|---|---|
|
Indica que o TM é volátil e não executa a recuperação. |
[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
| 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 |