clfsAdvanceLogBase 函数 (wdm.h)

ClfsAdvanceLogBase 例程设置 CLFS 流的基 LSN。

语法

CLFSUSER_API NTSTATUS ClfsAdvanceLogBase(
  [in, out] PVOID     pvMarshalContext,
  [in]      PCLFS_LSN plsnBase,
  [in]      ULONG     fFlags
);

[in, out] pvMarshalContext

指向表示与 CLFS 流关联的封送区域的不透明上下文的指针。调用方以前通过调用 ClfsCreateMarshallingArea 获取了此指针。

[in] plsnBase

指向包含新基本 LSN 的 CLFS_LSN 结构的指针。此参数必须是流中其中一条记录的 LSN。此外，此参数必须大于或等于流的当前基础 LSN，并且必须小于或等于流的当前最后一个 LSN。

[in] fFlags

此参数保留供系统使用。调用方必须将此参数设置为零。

如果成功，ClfsAdvanceLogBase 将返回STATUS_SUCCESS;否则，它将返回 Ntstatus.h 中定义的错误代码之一。

ClfsAdvanceLogBase 不会将任何记录写入 CLFS 日志;仅对日志的更新位于元数据中。如果要更新基本 LSN 并同时将重启记录写入流，请调用 ClfsWriteRestartArea。

如果可能，CLFS 会避免将 LSN 小于新基本 LSN 的排队日志记录写入稳定存储。

ClfsAdvanceLogBase 不会检查查看 plsnBase 中提供的 LSN 是否实际上是流中某个记录的 LSN。如果调用方将 plsnBase 设置为不是流中某个记录的 LSN 的 LSN，则流的基 LSN 将设置为无意义的值。

有关 CLFS 概念和术语的说明，请参阅通用日志文件系统。

要求	值
最低受支持的客户端	在 Windows Server 2003 R2、Windows Vista 和更高版本的 Windows 中可用。
目标平台	桌面
标头	wdm.h (包括 Wdm.h)
Library	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL