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
PDH _ argument non valide _
Un ou plusieurs des arguments sont non valides ou incorrects.
_échec d' _ allocation de mémoire PDH _
Impossible d’allouer une mémoire tampon.
_handle PDH non valide _
Le descripteur de requête n’est pas valide.
PDH _ CSTATUS _ aucun _ compteur
Le compteur spécifié est introuvable.
PDH _ CSTATUS _ aucun _ objet
L’objet spécifié est introuvable.
PDH _ CSTATUS _ aucun _ ordinateur
Une entrée d’ordinateur n’a pas pu être créée.
PDH _ CSTATUS _ , _ COUNTERNAME incorrect
Une chaîne de chemin d’accès de nom de compteur vide a été transmise.
_fonction PDH _ _ introuvable
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
PDH. lib
DLL
Pdh.dll

Voir aussi

PdhVbOpenQuery