iLog：：Force 方法 (txlogpub.h)

  • 项目

强制将日志的内容强制到磁盘，至少通过指定的 LSN。

语法

HRESULT Force(
  [in] LSN lsnMinToForce
);

参数

[in] lsnMinToForce

至少，目前必须将 LSN 小于或等于 lsnMinToForce 的所有尚未写入磁盘的记录写入磁盘。 但是，实现可以选择写入比严格要求更多的记录。 例如，无论 lsnMinToForce 的值如何，都允许实现将所有记录强制到磁盘。 将 0 作为 lsnMinToForce 传递表示将整个日志强制到磁盘。

返回值

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

追加单个记录后，也可能强制将日志强制到磁盘。 请参阅 ILog：：AppendRecord。

调用方备注

失败返回值指示自上次成功强制日志以来追加到日志的任何记录都不能保证位于磁盘上。 ILog 接口不提供用于确定哪些记录已成功写入磁盘的方法。 如果需要知道哪些记录已成功写入磁盘，则必须对每条记录强制使用日志。 请参阅 ILog：：AppendRecord。

实施者说明

例如，建议在从此方法返回之前，使用 FlushFileBuffers 函数) 刷新文件缓冲区 (。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 txlogpub.h

另请参阅

FlushFileBuffers

ILog