Método ILog::Force (txlogpub.h)

Força o conteúdo do log para o disco, pelo menos até o LSN especificado.

Sintaxe

HRESULT Force(
  [in] LSN lsnMinToForce
);

Parâmetros

[in] lsnMinToForce

No mínimo, todos os registros que ainda não foram gravados em disco com um LSN menor ou igual a lsnMinToForce devem ser gravados no disco agora. No entanto, uma implementação pode optar por gravar mais registros do que o que é estritamente necessário. Por exemplo, uma implementação tem permissão para forçar todos os registros para o disco, independentemente do valor de lsnMinToForce. Passar 0 como lsnMinToForce indica que todo o log deve ser forçado ao disco.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O log também pode ser forçado ao disco depois de acrescentar registros individuais. Consulte ILog::AppendRecord.

Anotações para chamadores

Um valor retornado de falha indica que todos os registros acrescentados ao log desde a última vez em que ele foi forçado com êxito não têm garantia de estar em disco. A interface ILog não fornece um método para determinar quais registros foram gravados com êxito no disco. Se você precisar saber quais registros foram gravados com êxito no disco, deverá forçar o log para cada registro. Consulte ILog::AppendRecord.

Anotações aos implementadores

É recomendável que você libere buffers de arquivo (por exemplo, usando a função FlushFileBuffers ) antes de retornar desse método.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	txlogpub.h

Confira também

FlushFileBuffers

Ilog