PdhUpdateLogFileCatalog-Funktion (pdh.h)

Synchronisiert die Informationen im Protokolldateikatalog mit den Leistungsdaten in der Protokolldatei.

Hinweis Diese Funktion ist veraltet.

 

Syntax

PDH_FUNCTION PdhUpdateLogFileCatalog(
  [in] PDH_HLOG hLog
);

Parameter

[in] hLog

Verarbeiten Sie die Protokolldatei, die den zu aktualisierenden Dateikatalog enthält. Die PdhOpenLog-Funktion .

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode oder ein PDH-Fehlercode. Die folgenden Werte sind möglich.

Rückgabecode	Beschreibung
PDH_NOT_IMPLEMENTED	Es wurde ein Handle für eine CSV- oder TSV-Protokolldatei angegeben. Diese Protokolldateitypen verfügen nicht über Kataloge.
PDH_UNKNOWN_LOG_FORMAT	Es wurde ein Handle für eine Protokolldatei mit einem unbekannten Format angegeben.
PDH_INVALID_HANDLE	Das Handle ist ungültig.

Hinweise

Der Protokolldateikatalog dient als Index für die Leistungsdatensätze in der Protokolldatei und ermöglicht eine schnellere Suche nach einzelnen Datensätzen in der Datei.

Kataloge sollten aktualisiert werden, wenn der Datensammlungsprozess abgeschlossen und die Protokolldatei geschlossen wurde. Der Katalog kann während der Datensammlung aktualisiert werden, aber dies kann den Prozess der Protokollierung der Leistungsdaten stören, da das Aktualisieren der Kataloge zeitaufwändig sein kann.

Perfmon-, CSV- und TSV-Protokolldateien verfügen nicht über Kataloge. Die Angabe eines Handles für diese Protokolldateitypen führt zu einem Rückgabewert von PDH_NOT_IMPLEMENTED.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	pdh.h
Bibliothek	Pdh.lib
DLL	Pdh.dll

Weitere Informationen

PdhGetLogFileSize

PdhUpdateLog