Função OpenTransactionManager (ktmw32.h)

Artigo
03/13/2024

Abre um gerenciador de transações existente.

Sintaxe

HANDLE OpenTransactionManager(
  [in]           LPWSTR      LogFileName,
  [in]           ACCESS_MASK DesiredAccess,
  [in, optional] ULONG       OpenOptions
);

Parâmetros

[in] LogFileName

O nome do fluxo de log. Esse fluxo deve existir em um arquivo de log CLFS.

[in] DesiredAccess

O acesso solicitado. Consulte Máscaras de Acesso do Gerenciador de Transações para obter uma lista de valores válidos.

[in, optional] OpenOptions

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.

O LogFileName deve ser especificado usando o formato de arquivo NT. Por exemplo: ?? < drive>:< caminho>. Não use o . Extensão BLF.

Requisitos

Requisito	Valor
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