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 结构的指针，该结构提供要删除的容器的路径名称。 路径名称是在上一次调用 ClfsAddLogContainer 或 ClfsAddLogContainerSet 中创建的。 路径可以是绝对路径，也可以是相对于 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) |
| Library | Clfs.lib |
| DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |