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

另请参阅

ClfsCloseAndResetLogFile

ClfsCloseLogFileObject

ClfsCreateLogFile

ClfsDeleteLogByPointer