clfsCloseLogFileObject 函数 (wdm.h)

ClfsCloseLogFileObject 例程释放对日志文件对象的所有引用。

语法

CLFSUSER_API NTSTATUS ClfsCloseLogFileObject(
  [in] PLOG_FILE_OBJECT plfoLog
);

[in] plfoLog

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

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

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

ClfsCloseLogFileObject 导致指定的日志文件对象的引用计数下降到零，此时日志文件对象关闭 (也就是说，其内存) 解除分配。但是，日志文件对象表示的流可能保持打开状态，因为可能存在表示同一流的其他日志文件对象。关闭表示流的所有日志文件对象后，将关闭流。

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

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

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