Função ReadOnlyEnlistment (ktmw32.h)

  • Artigo

Solicita que a inscrição especificada seja convertida em uma inscrição somente leitura. Uma inscrição somente leitura não pode participar do resultado da transação e não é registrada de forma durável para recuperação.

Sintaxe

BOOL ReadOnlyEnlistment(
  [in] HANDLE         EnlistmentHandle,
  [in] PLARGE_INTEGER TmVirtualClock
);

Parâmetros

[in] EnlistmentHandle

Um identificador para a inscrição.

[in] TmVirtualClock

O valor mais recente do relógio virtual recebido para essa inscrição. Se você especificar NULL, o valor do relógio virtual não será alterado. Confira LARGE_INTEGER.

Para alterar o valor do relógio virtual, esse valor deve ser maior que o valor atual retornado na notificação COMMIT.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será 0 (zero). 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

Se um gerenciador de recursos não precisar mais participar de uma transação sem reverter a transação, ele deverá chamar ReadOnlyEnlistment antes de fechar o identificador de inscrição.

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

GetCurrentClockTransactionManager

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

ReadOnlyEnlistment