clfsCloseAndResetLogFile 函数 (wdm.h)

ClfsCloseAndResetLogFile 例程释放对指定日志文件对象的所有引用,并将其关联的流标记为重置。

语法

CLFSUSER_API NTSTATUS ClfsCloseAndResetLogFile(
  [in] PLOG_FILE_OBJECT plfoLog
);

参数

[in] plfoLog

指向将为其释放引用 的LOG_FILE_OBJECT 结构的指针。 调用方之前通过调用 ClfsCreateLogFile 获取了此指针。

返回值

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

注解

ClfsCloseAndResetLogFile 将 CLFS 获取的所有引用释放到指定的日志文件对象。 通常,客户端不会获取对日志文件对象的任何其他引用。 但是,如果客户端已获取其他引用,则客户端负责释放它们。

ClfsCloseAndResetLogFile 导致指定的日志文件对象的引用计数下降到零,此时日志文件对象关闭 (也就是说,其内存) 解除分配。 但是,日志文件对象表示的流可能不会重置,因为可能存在表示同一流的其他日志文件对象。 在 (通过调用 ClfsCloseLogFileObject) 等方式关闭表示流的所有日志文件对象后,将重置流。

重置流类似于新创建的流,该流从未向其中写入任何记录。

从此例程返回时, plfoLog 无效。

对于给定流,最多可以调用 ClfsCloseAndResetLogFile 124 次。

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

要求

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

另请参阅

ClfsCloseLogFileObject

ClfsDeleteLogByPointer

ClfsDeleteLogFile