PdhVbGetCounterPathElements-Funktion

Die PdhVbGetCounterPathElements-Funktion analysiert eine vollqualifizierte Leistungsindikatorpfadzeichenfolge in die einzelnen Elemente. Jede der Zeichenfolgenvariablen muss die gleiche 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 unter Leistungsindikatorenfunktionen beschriebenen Funktionen zu verwenden.

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

Zählerpfadzeichenfolge, die in die einzelnen Elemente unterteilt werden soll.

MachineName

Zeichenfolge, um den Computernamen zu erhalten.

ObjectName

Zeichenfolge zum Empfangen des Objektnamens.

InstanceName

Zeichenfolge, um den instance Namen zu erhalten, falls verwendet.

ParentInstance

Zeichenfolge zum Empfangen des übergeordneten instance, falls verwendet.

CounterName

Zeichenfolge zum Empfangen des Leistungsindikatornamens.

BufferSize

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

Rückgabewert

Wenn die Funktion erfolgreich ist, wird eine ganzzahlige Long-Zahl 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 aufgeführt.

Rückgabecode	Beschreibung
PDH_INVALID_ARGUMENT	Mindestens einer der Zeichenfolgenpuffer ist nicht die richtige Größe.
PDH_MORE_DATA	Mindestens eins der Indikatorenpfadelemente ist für die Rückgabepufferlänge zu groß.
PDH_MEMORY_ALLOCATION_FAILURE	Ein temporärer Speicherpuffer konnte nicht zugewiesen 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

PdhVbCreateCounterPathList

PdhVbGetCounterPathFromList

PdhVbGetOneCounterPath