ClfsSetEndOfLog 函数 (wdm.h)

ClfsSetEndOfLog 例程截断 CLFS 流。

语法

CLFSUSER_API NTSTATUS ClfsSetEndOfLog(
  [in] PLOG_FILE_OBJECT plfoLog,
  [in] PCLFS_LSN        plsnEnd
);

参数

[in] plfoLog

指向表示 CLFS 流的 LOG_FILE_OBJECT 结构的指针。 此流必须是专用日志的唯一流。 调用方之前通过调用 ClfsCreateLogFile获取此指针。

[in] plsnEnd

指向 CLFS_LSN 结构的指针,该结构提供要成为流的最后一条记录的记录的 LSN。 这必须是流中其中一条记录的确切 LSN。

返回值

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

言论

未验证在 plsnEnd 值中提供的 LSN。 调用方负责提供有效的 LSN;也就是说,它是流中记录的确切 LSN。

此由 plfoLog 表示的流必须来自专用日志。 此例程不支持多路复用日志中的流。

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

clfsSetEndOfLog 的内核模式例程 保留以供将来使用,当前始终返回STATUS_NOT_SUPPORTED。 但是,目前支持 setEndOfLog 的用户模式例程

要求

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

另请参阅

CLFS_LSN

ClfsAdvanceLogBase

ClfsCreateLogFile

ClfsSetArchiveTail

ClfsSetEndOfLog

LOG_FILE_OBJECT