Compartilhar via


Função OpenTransaction (ktmw32.h)

Abre uma transação existente.

Sintaxe

HANDLE OpenTransaction(
  [in] DWORD  dwDesiredAccess,
  [in] LPGUID TransactionId
);

Parâmetros

[in] dwDesiredAccess

O acesso ao objeto de transação. Você deve ter acesso de leitura e gravação para trabalhar com uma transação. Consulte Máscaras de Acesso à Transação para obter uma lista de valores válidos.

[in] TransactionId

O GUID que identifica a transação a ser aberta. Normalmente, isso é conhecido como uma unidade de trabalho para a transação.

Valor retornado

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

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

Os clientes fecham o identificador de transação usando a função CloseHandle . Se o último identificador de transação for fechado sem que ninguém chame a função CommitTransaction na transação, o KTM reverterá implicitamente a transação.

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

Confira também

Committransaction

Createtransaction

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

RollbackTransaction

Máscaras de Acesso à Transação