PdhUpdateLogFileCatalog 函数 (pdh.h)

将日志文件目录中的信息与日志文件中的性能数据同步。

注意此函数已过时。

语法

PDH_FUNCTION PdhUpdateLogFileCatalog(
  [in] PDH_HLOG hLog
);

[in] hLog

包含要更新的文件目录的日志文件的句柄。 PdhOpenLog 函数。

如果函数成功，则返回ERROR_SUCCESS。

如果函数失败，则返回值为系统错误代码或 PDH 错误代码。下面是可能的值。

返回代码	说明
PDH_NOT_IMPLEMENTED	指定了 CSV 或 TSV 日志文件的句柄。这些日志文件类型没有目录。
PDH_UNKNOWN_LOG_FORMAT	指定了具有未知格式的日志文件的句柄。
PDH_INVALID_HANDLE	句柄无效。

日志文件目录用作日志文件中性能数据记录的索引，从而可以更快地搜索文件中的各个记录。

当数据收集过程完成且日志文件已关闭时，应更新目录。可以在数据收集期间更新目录，但这样做可能会中断记录性能数据的过程，因为更新目录可能很耗时。

Perfmon、CSV 和 TSV 日志文件没有目录。指定这些日志文件类型的句柄将导致返回值PDH_NOT_IMPLEMENTED。