Função ReadOnlyEnlistment (ktmw32.h)

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

Confira também

GetCurrentClockTransactionManager

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

ReadOnlyEnlistment