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 |