ClfsRemoveLogContainer 函数 (wdm.h)

ClfsRemoveLogContainer 例程从 CLFS 日志中删除容器。

语法

CLFSUSER_API NTSTATUS ClfsRemoveLogContainer(
  [in] PLOG_FILE_OBJECT plfoLog,
  [in] PUNICODE_STRING  puszContainerPath,
  [in] BOOLEAN          fForce
);

参数

[in] plfoLog

指向 LOG_FILE_OBJECT 结构的指针,该结构表示将从中删除容器的 CLFS 日志。 调用方之前通过调用 ClfsCreateLogFile获取此指针。

[in] puszContainerPath

指向 UNICODE_STRING 结构的指针,该结构提供要删除的容器的路径名称。 路径名称是在上一次调用 clfsAddLogContainerClfsAddLogContainerSet中创建的。 该路径可以是由 plfoLog表示的 CLFS 日志的基日志文件位置的绝对路径或相对路径。 相对于基日志文件的路径必须以CLFS_CONTAINER_RELATIVE_PREFIX开头,即字符串文本(L“%BLF%\)。 相对路径中不允许目录“.”和“.”。

[in] fForce

一个布尔值,指定容器删除是强制的(TRUE) 还是懒惰(FALSE)。

返回值

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

言论

强制删除容器(fForce = TRUE)仅在要删除的容器不是活动日志的一部分时才成功。

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

要求

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

另请参阅

ClfsAddLogContainer

ClfsAddLogContainerSet

ClfsCreateLogFile

ClfsRemoveLogContainerSet

LOG_FILE_OBJECT

UNICODE_STRING