PdhUpdateLogA-Funktion (pdh.h)

Erfasst Leistungsindikatorendaten für die aktuelle Abfrage und schreibt die Daten in die Protokolldatei.

Syntax

PDH_FUNCTION PdhUpdateLogA(
  [in] PDH_HLOG hLog,
  [in] LPCSTR   szUserString
);

Parameter

[in] hLog

Handle einer einzelnen Protokolldatei, die aktualisiert werden soll. Die PdhOpenLog-Funktion gibt dieses Handle zurück.

[in] szUserString

Null-Zeichenfolge, die einen benutzerdefinierten Kommentar enthält, der dem Datensatz hinzugefügt werden soll. Die Zeichenfolge darf nicht leer sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS zurück.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode oder ein PDH-Fehlercode. Im Folgenden sind mögliche Werte aufgeführt.

Rückgabecode	Beschreibung
PDH_INVALID_HANDLE	Das Protokolldateihandle ist ungültig.
PDH_INVALID_ARGUMENT	Im szUserString-Parameter wurde eine leere Zeichenfolge übergeben.

Hinweise

Wenn Sie eine Protokolldatei aus einer anderen Protokolldatei aktualisieren, werden die Kommentare aus der anderen Protokolldatei nicht migriert.

Beispiele

Ein Beispiel finden Sie unter Schreiben von Leistungsdaten in eine Protokolldatei.

Hinweis

Der pdh.h-Header definiert PdhUpdateLog als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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

PdhOpenLog

PdhOpenQuery

PdhUpdateLogFileCatalog