pdhUpdateLogFileCatalog 函式 (pdh.h)

同步處理記錄檔目錄中的資訊與記錄檔中的效能資料。

注意此函式已過時。

語法

PDH_FUNCTION PdhUpdateLogFileCatalog(
  [in] PDH_HLOG hLog
);

[in] hLog

包含要更新之檔案目錄的記錄檔句柄。 PdhOpenLog 函式。

如果函式成功，它會傳回ERROR_SUCCESS。

如果函式失敗，傳回值為系統錯誤碼或 PDH 錯誤碼。以下是可能的值。

傳回碼	Description
PDH_NOT_IMPLEMENTED	已指定 CSV 或 TSV 記錄檔的句柄。這些記錄檔檔類型沒有目錄。
PDH_UNKNOWN_LOG_FORMAT	已指定具有未知格式的記錄檔句柄。
PDH_INVALID_HANDLE	句柄無效。

記錄檔目錄可作為記錄檔中效能數據記錄的索引，提供更快速的檔案中個別記錄的搜尋。

當資料收集程式完成且記錄檔已關閉時，應該更新目錄。目錄可以在數據收集期間更新，但這樣做可能會中斷記錄效能數據的程式，因為更新目錄可能相當耗時。

Perfmon、CSV 和 TSV 記錄檔沒有目錄。指定這些記錄檔類型的句柄會導致傳回值PDH_NOT_IMPLEMENTED。