PdhVbUpdateLog-Funktion
Die Funktion PdhVbUpdateLog aktualisiert die aktuelle Abfrage und schreibt neue Daten in die Protokolldatei. Diese Funktion ruft PdhUpdateLog auf.
Wichtig
Die in diesem Thema beschriebene Funktion kann in Zukunft geändert oder nicht mehr verfügbar sein. Stattdessen empfiehlt Microsoft, die unter Leistungsindikatorenfunktionen beschriebenen Funktionen zu verwenden.
Funktion PdhVbUpdateLog( _ ByVal hLog As PDH_HLOG, _ ByVal szUserString As LPCTSTR _ )
Parameter
-
hLog [in]
-
Behandeln Sie die zu aktualisierende Protokolldatei. Dieses Handle wird von der PdhVbOpenLog-Funktion zurückgegeben.
-
szUserString [in]
-
Zeiger auf eine Zeichenfolge, die die Daten angibt, die der Protokolldatei hinzugefügt werden sollen. Dies wird in der Regel für Kommentare in der Protokolldatei verwendet.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie 0 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 |
|---|---|
|
Die angeforderten Daten sind größer als der bereitgestellte Puffer. Die angeforderten Daten können nicht zurückgegeben werden. |
|
Mindestens einer der Zeichenfolgenpuffer ist nicht die richtige Größe. |
|
Das Handle ist kein gültiges PDH-Objekt. |
|
Die angegebene Protokolldatei kann nicht geöffnet werden. |
|
Die angegebene Datei konnte nicht gefunden werden. |
Bemerkungen
Es muss eine aktuell geöffnete Abfrage vorhanden sein, und die gewünschten Leistungsindikatoren müssen hinzugefügt werden, bevor diese Funktion aufgerufen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| Bibliothek |
|
| DLL |
|