DeleteLogByHandle 函数 (clfsw32.h)

标记要删除的指定日志。关闭日志的所有句柄、封送区域和读取上下文时，实际上会删除日志。如果日志是物理日志，则删除其基础容器。

将日志标记为要删除时，打开新客户端日志流的请求会失败。

注意此函数不同于 DeleteLogFile，因为它需要对日志对象使用有效的打开句柄，而不是日志名称。

语法

CLFSUSER_API BOOL DeleteLogByHandle(
  [in] HANDLE hLog
);

[in] hLog

打开的日志的句柄，该句柄是通过成功调用 CreateLogFile 获取的。日志必须已使用 DELETE 访问权限创建，否则无法删除日志。

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零 (0)。要获得更多的错误信息，请调用 GetLastError。以下列表标识了可能的错误代码：