Compartir a través de


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

Fuerza el contenido del registro al disco, al menos hasta el LSN especificado.

Sintaxis

HRESULT Force(
  [in] LSN lsnMinToForce
);

Parámetros

[in] lsnMinToForce

Al menos, todos los registros que aún no se han escrito en el disco con un LSN menor o igual que lsnMinToForce deben escribirse ahora en el disco. Sin embargo, una implementación puede optar por escribir más registros que lo que es estrictamente necesario. Por ejemplo, una implementación puede forzar todos los registros al disco, independientemente del valor de lsnMinToForce. Pasar 0 como lsnMinToForce indica que todo el registro se va a forzar al disco.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El registro también se puede forzar al disco después de anexar registros individuales. Consulte ILog::AppendRecord.

Notas a los autores de llamadas

Un valor devuelto de error indica que no se garantiza que los registros anexados al registro desde la última vez que se ha forzado correctamente no estén en el disco. La interfaz ILog no proporciona un método para determinar qué registros se han escrito correctamente en el disco. Si necesita saber qué registros se escribieron correctamente en el disco, debe forzar el registro para cada registro. Consulte ILog::AppendRecord.

Notas para los implementadores

Se recomienda vaciar los búferes de archivos (por ejemplo, mediante la función FlushFileBuffers ) antes de volver de este método.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado txlogpub.h

Consulte también

FlushFileBuffers

Ilog