PdhVbGetCounterPathElements, fonction
La fonction PdhVbGetCounterPathElements analyse une chaîne de chemin d’accès de compteur de performances complète dans ses éléments individuels. Chacune des variables de chaîne doit avoir la même taille (BufferSize) et dimensionnée et initialisée avant d’être utilisée dans cette fonction.
Important
La fonction décrite dans cette rubrique peut être modifiée ou indisponible à l’avenir. Au lieu de cela, Microsoft vous recommande d’utiliser les fonctions décrites dans Fonctions des compteurs de performances.
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
Paramètres
-
PathString
-
Chaîne de chemin de compteur qui doit être divisée en ses éléments individuels.
-
MachineName
-
Chaîne pour recevoir le nom de l’ordinateur.
-
ObjectName
-
Chaîne pour recevoir le nom de l’objet.
-
InstanceName
-
Chaîne pour recevoir le nom instance, si elle est utilisée.
-
ParentInstance
-
Chaîne pour recevoir le instance parent, si elle est utilisée.
-
CounterName
-
Chaîne pour recevoir le nom du compteur.
-
BufferSize
-
Taille maximale de chaque variable de chaîne utilisée comme paramètre pour cet appel de fonction.
Valeur retournée
Si la fonction réussit, elle retourne un entier Long égal à ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour est un code d’erreur système ou un code d’erreur PDH. Voici les valeurs possibles.
| Code de retour | Description |
|---|---|
|
Une ou plusieurs des mémoires tampons de chaîne ne sont pas de taille correcte. |
|
Un ou plusieurs éléments de chemin de compteur sont trop volumineux pour la longueur de la mémoire tampon de retour. |
|
Impossible d’allouer une mémoire tampon temporaire. |
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2003 [applications de bureau uniquement] |
| Bibliothèque |
|
| DLL |
|