PdhVbAddCounter fonction)
La fonction PdhVbAddCounter crée une entrée de compteur dans l’objet de requête spécifié et retourne un handle à ce compteur en cas de réussite.
Important
La fonction décrite dans cette rubrique peut être modifiée ou non disponible à l’avenir. Au lieu de cela, Microsoft vous recommande d’utiliser les fonctions décrites dans fonctions des compteurs de performances.
Function PdhVbAddCounter ( _ ByVal QueryHandle As long, _ ByVal trajet As String, _ ByVal CounterHandle As long _ ) As long
Paramètres
-
QueryHandle
-
ID de la requête à laquelle ce compteur doit être assigné. Cette valeur est retournée par la fonction PdhVbOpenQuery .
-
CounterPath
-
Chaîne de texte qui spécifie le nom du chemin d’accès au compteur à ajouter à la requête. Le contenu de cette chaîne doit être un chemin de compteur valide, tel qu’il est obtenu à partir de l’Explorateur de compteurs ou d’une autre source.
-
CounterHandle
-
Référence unique qui identifie ce compteur dans la requête. Cette variable doit être initialisée à zéro avant que la fonction ne soit appelée. Elle contient une valeur valide lors du retour uniquement si la fonction se termine correctement.
Valeur de retour
Si la fonction réussit, elle retourne un entier long égal à _ l’erreur Success et un nouveau handle dans la variable CounterHandle .
Si la fonction échoue, la valeur de retour est un code d’erreur système ou un code d’erreur PDH. Les valeurs possibles sont les suivantes.
| Code de retour | Description |
|---|---|
|
Un ou plusieurs des arguments sont non valides ou incorrects. |
|
Impossible d’allouer une mémoire tampon. |
|
Le descripteur de requête n’est pas valide. |
|
Le compteur spécifié est introuvable. |
|
L’objet spécifié est introuvable. |
|
Une entrée d’ordinateur n’a pas pu être créée. |
|
Une chaîne de chemin d’accès de nom de compteur vide a été transmise. |
|
La fonction de calcul de ce compteur n’a pas pu être déterminée. |
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows [Applications de bureau XP uniquement] |
| Serveur minimal pris en charge |
Windows Serveur 2003 [ applications de bureau uniquement] |
| Bibliothèque |
|
| DLL |
|