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) |
库 | Clfs.lib |
DLL | Clfs.sys |
IRQL | <= APC_LEVEL |