ClfsDeleteLogFile 函数 (wdm.h)
ClfsDeleteLogFile 例程标记要删除的 CLFS 流。
语法
CLFSUSER_API NTSTATUS ClfsDeleteLogFile(
[in] PUNICODE_STRING puszLogFileName,
PVOID pvReserved,
[in] ULONG fLogOptionFlag,
[in, optional] PVOID pvContext,
[in] ULONG cbContext
);
参数
[in] puszLogFileName
指向 UNICODE_STRING 结构的指针,该结构提供要删除的 CLFS 流的名称。
如果要删除的流是专用日志的唯一流,则名称具有表单日志:物理日志名称,其中 物理日志名称 是基础文件系统上物理日志的路径名称。
如果要删除的流是多路复用日志的流之一,则名称具有表单日志:物理日志名称::流名称,其中 物理日志名称 是基础文件系统上物理日志的路径名称,流名称 是要删除的流的唯一名称。
pvReserved
保留。
[in] fLogOptionFlag
一个值,指示 CLFS 与正在删除日志的组件之间的关系。 有关可能值的列表,请参阅 ClfsCreateLogFile 例程的 fLogOptionFlag 参数的说明。
[in, optional] pvContext
指向上下文的指针。 上下文的解释方式取决于 fLogOptionFlag中传递的值。
[in] cbContext
pvContext 指向的上下文的大小(以字节为单位)。 如果未 NULLpvContext,则此参数必须大于零。
返回值
ClfsDeleteLogFile 如果成功,则返回STATUS_SUCCESS;否则,它将返回 Ntstatus.h 中定义的错误代码之一。
言论
通用日志文件系统(CLFS)使用LOG_FILE_OBJECT结构来表示日志。 ClfsCreateLogFile 函数返回指向LOG_FILE_OBJECT的指针,客户端随后将传递给其他 CLFS 函数。
CLFS 客户端不直接访问LOG_FILE_OBJECT结构的成员。 有关成员的信息,请参阅 FILE_OBJECT。
ClfsDeleteLogFile 标记要删除的流,但不关闭当前打开的任何日志文件对象。 若要关闭日志文件对象,请调用 ClfsCloseLogFileObject。 在关闭与流关联的所有日志文件对象后,将删除标记为删除的流。
标记为删除的 CLFS 流将拒绝后续请求以打开流。
物理 CLFS 日志的名称不包括 .blf 扩展名。
有关 CLFS 概念和术语的说明,请参阅 通用日志文件系统。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 在 Windows Server 2003 R2、Windows Vista 和更高版本的 Windows 中可用。 |
目标平台 | 桌面 |
标头 | wdm.h (包括 Wdm.h) |
库 | Clfs.lib |
DLL | Clfs.sys |
IRQL | <= APC_LEVEL |