PdhUpdateLogA-Funktion (pdh.h)
Sammelt 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 diesen Handle zurück.
[in] szUserString
Null-beendete Zeichenfolge, die einen benutzerdefinierten Kommentar enthält, der dem Datensatz hinzugefügt werden soll. Die Zeichenfolge kann nicht leer sein.
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. Im Folgenden sind mögliche Werte aufgeführt.
| Rückgabecode | Beschreibung |
|---|---|
|
Das Protokolldateihandle ist ungültig. |
|
Eine leere Zeichenfolge wurde im szUserString Parameter übergeben. |
Bemerkungen
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.
Anmerkung
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 Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | pdh.h |
| Library | Pdh.lib |
| DLL- | Pdh.dll |