PdhVbAddCounter-Funktion

Die PdhVbAddCounter-Funktion erstellt einen Zählereintrag im angegebenen Abfrageobjekt und gibt nach erfolgreicher Fertigstellung ein Handle für diesen Zähler zurück.

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.

Function PdhVbAddCounter( _ ByVal QueryHandle As Long, _ ByVal CounterPath As String, _ ByVal CounterHandle As Long _ ) As Long

Parameter

QueryHandle

ID der Abfrage, der dieser Indikator zugewiesen werden soll. Dieser Wert wird von der PdhVbOpenQuery-Funktion zurückgegeben.

CounterPath

Textzeichenfolge, die den Namen des Leistungsindikatorpfads angibt, der der Abfrage hinzugefügt werden soll. Der Inhalt dieser Zeichenfolge muss ein gültiger Zählerpfad sein, wie er vom Indikatorenbrowser oder einer anderen Quelle abgerufen wird.

CounterHandle

Eindeutiger Verweis, der diesen Indikator in der Abfrage identifiziert. Diese Variable muss auf null initialisiert werden, bevor die Funktion aufgerufen wird. Es enthält nur einen gültigen Wert bei rückgabe, wenn die Funktion erfolgreich abgeschlossen wurde.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie eine ganze Long-Zahl zurück, die ERROR_SUCCESS und ein neues Handle in der CounterHandle-Variablen enthält.

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_ARGUMENT	Mindestens eines der Argumente ist ungültig oder falsch.
PDH_MEMORY_ALLOCATION_FAILURE	Ein Speicherpuffer konnte nicht zugewiesen werden.
PDH_INVALID_HANDLE	Das Abfragehandle ist ungültig.
PDH_CSTATUS_NO_COUNTER	Der angegebene Leistungsindikator wurde nicht gefunden.
PDH_CSTATUS_NO_OBJECT	Das angegebene Objekt konnte nicht gefunden werden.
PDH_CSTATUS_NO_MACHINE	Ein Computereintrag konnte nicht erstellt werden.
PDH_CSTATUS_BAD_COUNTERNAME	Eine leere Zählernamenpfadzeichenfolge wurde übergeben.
PDH_FUNCTION_NOT_FOUND	Die Berechnungsfunktion für diesen Zähler konnte nicht ermittelt werden.

Anforderungen

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

Siehe auch

PdhVbOpenQuery