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になります。