共用方式為


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。

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 pdh.h
程式庫 Pdh.lib
Dll Pdh.dll

另請參閱

PdhGetLogFileSize

PdhUpdateLog