Partager via


Counters.Add, méthode

Ajoute un instance CounterItem à la collection.

Syntaxe

Counters.Add( _
  ByVal pathname As String _
) As CounterItem

Paramètres

pathname [in]

Chemin du compteur. Le chemin d’accès peut inclure un nom d’ordinateur et doit inclure un nom d’objet de performance, un nom d’objet instance si l’objet de performance spécifié prend en charge plusieurs instances et un nom de compteur. Cette spécification de chemin d’accès ne respecte pas la casse.

Pour plus d’informations sur la spécification d’un chemin de compteur, consultez Spécification d’un chemin de compteur.

Exceptions

Type d'exception Condition
System.Runtime.InteropServices.COMException Vous pouvez recevoir cette exception pour l’une des raisons suivantes :
  • L’objet de performances spécifié est introuvable sur l’ordinateur. La valeur Err.Number est 0xC0000BB8.
  • Le compteur spécifié est introuvable. La valeur Err.Number est 0xC0000BB9.

Notes

Si vous spécifiez un compteur générique dans le paramètre pathname , la méthode Add crée un objet CounterItem pour chaque chemin développé. La méthode Add retourne ensuite un pointeur vers le premier CounterItem ajouté.

Si le caractère générique entraîne un compteur en double, l’erreur n’est pas signalée et aucun doublon n’est créé. Si une condition d’erreur se produit avant la création de tous les compteurs, l’erreur est signalée et les compteurs restants ne sont pas créés.

Il n’existe aucune limite au nombre de compteurs que vous pouvez ajouter; toutefois, SYSMON ne représentera que les 1 024 premiers compteurs de la collection. Il n’existe aucune limite quant au nombre de compteurs affichés par SYSMON dans un rapport.

Pour recevoir une notification lors de l’ajout d’un compteur, implémentez l’événement OnCounterAdded .

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server [applications de bureau uniquement]
DLL
Sysmon.ocx

Voir aussi

CounterItem

Counters

SystemMonitor.BrowseCounters