PdhVbGetCounterPathElements-Funktion

Die PdhVbGetCounterPathElements-Funktion analysiert eine vollqualifizierte Leistungsindikatorpfadzeichenfolge in ihre einzelnen Elemente. Jede der Zeichenfolgenvariablen muss dieselbe Größe (BufferSize) aufweisen und dimensioniert und initialisiert sein, bevor sie in dieser Funktion verwendet wird.

Wichtig

Die in diesem Thema beschriebene Funktion kann in Zukunft geändert oder nicht mehr verfügbar sein. Stattdessen empfiehlt Microsoft die Verwendung der in Leistungsindikatorfunktionen beschriebenenFunktionen.

Function PdhVbGetCounterPathElements( _ ByVal PathString As String, _ ByVal MachineName As String, _ ByVal ObjectName As String, _ ByVal InstanceName As String, _ ByVal ParentInstance As String, _ ByVal CounterName As String, _ ByVal BufferSize As Long _ ) As Long

Parameter

PathString

Indikatorpfadzeichenfolge, die in die einzelnen Elemente unterteilt werden soll.

MachineName

Zeichenfolge zum Empfangen des Computernamens.

ObjectName

Zeichenfolge zum Empfangen des Objektnamens.

InstanceName

Zeichenfolge zum Empfangen des Instanznamens, sofern verwendet.

ParentInstance

Zeichenfolge zum Empfangen der übergeordneten Instanz, wenn sie verwendet wird.

Countername

Zeichenfolge zum Empfangen des Indikatornamens.

BufferSize

Maximale Größe jeder Zeichenfolgenvariablen, die als Parameter für diesen Funktionsaufruf verwendet wird.

Rückgabewert

Wenn die Funktion erfolgreich ausgeführt wird, wird eine Long-Ganzzahl zurückgegeben, die error success _ entspricht.

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

Rückgabecode Beschreibung
_UNGÜLTIGES _ PDH-ARGUMENT
Mindestens einer der Zeichenfolgenpuffer ist nicht die richtige Größe.
PDH _ MORE _ DATA
Mindestens eines der Indikatorpfadelemente ist für die Länge des Rückgabepuffers zu groß.
_ _ _ PDH-SPEICHERBELEGUNGSFEHLER
Ein temporärer Speicherpuffer konnte nicht zugeordnet werden.

Requirements (Anforderungen)

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

Weitere Informationen

PdhVbCreateCounterPathList

PdhVbGetCounterPathFromList

PdhVbGetOneCounterPath