Método Counters.Add

Adiciona uma instância do CounterItem à coleção.

Sintaxe

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

Parâmetros

pathname [in]

Caminho para o contador. O caminho pode incluir um nome de computador e deve incluir um nome de objeto de desempenho, um nome de instância de objeto se o objeto de desempenho especificado der suporte a várias instâncias e um nome de contador. Essa especificação de caminho não diferencia maiúsculas de minúsculas.

Para obter detalhes sobre como especificar um caminho de contador, consulte Especificando um caminho de contador.

Exceções

Tipo de exceção Condição
System.Runtime.InteropServices.COMException Você pode receber essa exceção por um dos seguintes motivos:
  • O objeto de desempenho especificado não foi encontrado no computador. O valor Err.Number é 0xC0000BB8.
  • Não foi possível encontrar o contador especificado. O valor Err.Number é 0xC0000BB9.

Comentários

Se você especificar um contador curinga no parâmetro pathname , o método Add criará um objeto CounterItem para cada caminho expandido. Em seguida, o método Add retorna um ponteiro para o primeiro CounterItem adicionado.

Se o curinga resultar em um contador duplicado, o erro não será relatado e nenhuma duplicata será criada. Se ocorrer uma condição de erro antes de todos os contadores serem criados, o erro será relatado e os contadores restantes não serão criados.

Não há limite para o número de contadores que você pode adicionar; no entanto, o SYSMON grafará apenas os primeiros 1.024 contadores da coleção. Não há limite no número de contadores que o SYSMON exibirá em um relatório.

Para receber notificação quando um contador for adicionado, implemente o evento OnCounterAdded .

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
DLL
Sysmon.ocx

Confira também

CounterItem

Contadores

SystemMonitor.BrowseCounters