Função OpenTransaction (ktmw32.h)

Artigo
08/24/2023

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