Compartir a través de


Método Counters.Add

Agrega una instancia counterItem a la colección.

Sintaxis

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

Parámetros

pathname [in]

Ruta de acceso al contador. La ruta de acceso puede incluir un nombre de máquina y debe incluir un nombre de objeto de rendimiento, un nombre de instancia de objeto si el objeto de rendimiento especificado admite varias instancias y un nombre de contador. Esta especificación de ruta de acceso no distingue mayúsculas de minúsculas.

Para obtener más información sobre cómo especificar una ruta de acceso de contador, vea Especificar una ruta de acceso de contador.

Excepciones

Tipo de excepción Condición
System.Runtime.InteropServices.COMException Puede recibir esta excepción por uno de los siguientes motivos:
  • No se encontró el objeto de rendimiento especificado en el equipo. El valor Err.Number es 0xC0000BB8.
  • No se encontró el contador especificado. El valor Err.Number es 0xC0000BB9.

Comentarios

Si especifica un contador de caracteres comodín en el parámetro pathname , el método Add crea un objeto CounterItem para cada ruta de acceso expandida. A continuación, el método Add devuelve un puntero al primer CounterItem agregado.

Si el carácter comodín daría lugar a un contador duplicado, no se notifica el error y no se crea ningún duplicado. Si se produce una condición de error antes de crear todos los contadores, se notifica el error y no se crean los contadores restantes.

No hay ningún límite para el número de contadores que se pueden agregar; sin embargo, SYSMON grafo solo los primeros 1024 contadores de la colección. No hay ningún límite en el número de contadores que SYSMON mostrará en un informe.

Para recibir una notificación cuando se agrega un contador, implemente el evento OnCounterAdded .

Requisitos

Requisito Value
Cliente mínimo compatible
Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows 2000 Server [solo aplicaciones de escritorio]
Archivo DLL
Sysmon.ocx

Consulte también

CounterItem

Counters

SystemMonitor.BrowseCounters