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 |