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 |
|---|---|
|
Mindestens einer der Zeichenfolgenpuffer ist nicht die richtige Größe. |
|
Mindestens eines der Indikatorpfadelemente ist für die Länge des Rückgabepuffers zu groß. |
|
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 |
|
| DLL |
|