Compartilhar via


Função OpenTransactionManager (ktmw32.h)

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

Confira também

CreateTransactionManager

GetCurrentClockTransactionManager

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

OpenTransactionManagerById

Máscaras de acesso do Gerenciador de Transações