Partager via

Fonction PdhVbAddCounter

  • Article

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 d’achèvement réussi.

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 PdhVbAddCounter( _ ByVal QueryHandle As Long, _ ByVal CounterPath As String, _ ByVal CounterHandle As Long _ ) As Long

Paramètres

QueryHandle

ID de la requête à laquelle ce compteur doit être affecté. Cette valeur est retournée par la fonction PdhVbOpenQuery .

CounterPath

Chaîne de texte qui spécifie le nom du chemin du compteur à ajouter à la requête. Le contenu de cette chaîne doit être un chemin de compteur valide, tel qu’obtenu à partir du navigateur de compteur 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 l’appel de la fonction. Elle contient une valeur valide au retour uniquement si la fonction s’exécute correctement.

Valeur retournée

Si la fonction réussit, elle retourne un entier Long égal à ERROR_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. Voici les valeurs possibles.

Code de retour Description
PDH_INVALID_ARGUMENT
 Un ou plusieurs arguments n’est pas valide ou incorrect.
PDH_MEMORY_ALLOCATION_FAILURE
 Impossible d’allouer une mémoire tampon.
PDH_INVALID_HANDLE
 Le handle de requête n’est pas valide.
PDH_CSTATUS_NO_COUNTER
 Le compteur spécifié est introuvable.
PDH_CSTATUS_NO_OBJECT
 L’objet spécifié est introuvable.
PDH_CSTATUS_NO_MACHINE
 Impossible de créer une entrée d’ordinateur.
PDH_CSTATUS_BAD_COUNTERNAME
 Une chaîne de chemin de nom de compteur vide a été passée.
PDH_FUNCTION_NOT_FOUND
 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 XP [applications de bureau uniquement]
Serveur minimal pris en charge
 Windows Server 2003 [applications de bureau uniquement]
Bibliothèque
Pdh.lib
DLL
Pdh.dll

Voir aussi

PdhVbOpenQuery