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) |
Library | Clfs.lib |
DLL | Clfs.sys |
IRQL | <= APC_LEVEL |