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