PdhUpdateLogFileCatalog-Funktion (pdh.h)
Synchronisiert die Informationen im Protokolldateikatalog mit den Leistungsdaten in der Protokolldatei.
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 |
|---|---|
|
Es wurde ein Handle für eine CSV- oder TSV-Protokolldatei angegeben. Diese Protokolldateitypen verfügen nicht über Kataloge. |
|
Es wurde ein Handle für eine Protokolldatei mit einem unbekannten Format angegeben. |
|
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 |