Freigeben über


PdhVbGetOneCounterPath-Funktion

Die PdhVbGetOneCounterPath-Funktion zeigt ein Dialogfeld an, in dem der Benutzer die verfügbaren Leistungsindikatoren durchsuchen und einen Zähler auswählen kann. Der ausgewählte Indikator wird in der PathString-Variablen zurückgegeben. Die PathString-Variable muss dimensioniert und initialisiert werden, bevor diese Funktion aufgerufen wird, und die dimensionierte Größe muss durch die PathLength-Variable angegeben werden.

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 PdhVbGetOneCounterPath( _ ByVal PathString As String, _ ByVal PathLength As Long, _ ByVal DetailLevel As Long, _ ByVal CaptionString As String _ ) As Long

Parameter

PathString

Initialisierte Zeichenfolgenvariable, die zum Empfangen des vom Benutzer ausgewählten Zählerpfads verwendet wird.

PathLength

Länge des initialisierten PathString.

DetailLevel

Typen von Indikatoren, die im Dialogfeld angezeigt werden sollen. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
PERF_DETAIL_ADVANCED
Indikatoren, die der erweiterte Benutzer wahrscheinlich versteht, zusätzlich zu den Zählern für Anfänger.
PERF_DETAIL_EXPERT
Indikatoren, die der erfahrene Benutzer und Softwareentwickler wahrscheinlich verstehen wird, zusätzlich zu den Indikatoren für anfänger und fortgeschrittene Benutzer.
PERF_DETAIL_NOVICE
Nur Indikatoren, die der neue Benutzer wahrscheinlich versteht.
PERF_DETAIL_WIZARD
Alle Leistungsindikatoren im System.

CaptionString

Zeichenfolgenvariable, die den Text enthält, der in der Untertitel leiste des Dialogfelds angezeigt wird.

Rückgabewert

Die Funktion gibt die Anzahl der Zeichen zurück, die in den PathString-Puffer geschrieben wurden.

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

PdhVbGetCounterPathElements

PdhVbGetCounterPathFromList