ClfsRemoveLogContainerSet 函数 (wdm.h)

  • 项目

ClfsRemoveLogContainerSet 例程以原子方式从 CLFS 日志中删除一组容器。

语法

CLFSUSER_API NTSTATUS ClfsRemoveLogContainerSet(
  [in] PLOG_FILE_OBJECT plfoLog,
  [in] USHORT           cContainers,
  [in] PUNICODE_STRING  rgwszContainerPath,
  [in] BOOLEAN          fForce
);

参数

[in] plfoLog

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

[in] cContainers

集中的容器数。 这是 rgwszContainerPath 数组中的元素数。

[in] rgwszContainerPath

指向 UNICODE_STRING 结构的数组的指针，其中每个结构都提供要删除的容器之一的路径名称。 数组中的元素数由 cContainers 提供。 给定路径可以是绝对路径，也可以是相对于 plfoLog 表示的 CLFS 日志的基本日志文件的位置。 相对于基本日志文件的路径必须以 CLFS_CONTAINER_RELATIVE_PREFIX 开头，这是 L“%BLF%\”) (字符串文本。 不允许在相对路径中使用目录“.”和“..”。

[in] fForce

一个布尔值，指定容器删除是强制 (TRUE) 还是延迟 (FALSE) 。

返回值

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

注解

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

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

要求

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

另请参阅

ClfsAddLogContainerSet

ClfsCreateLogFile

ClfsRemoveLogContainer

LOG_FILE_OBJECT

UNICODE_STRING