Поделиться через


Метод Counters.Add

Добавляет экземпляр CounterItem в коллекцию.

Синтаксис

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

Параметры

pathname [in]

Путь к счетчику. Путь может включать имя компьютера и должен включать имя объекта производительности, имя экземпляра объекта, если указанный объект производительности поддерживает несколько экземпляров, и имя счетчика. В этой спецификации пути регистр не учитывается.

Дополнительные сведения об указании пути счетчика см. в разделе Указание пути счетчика.

Исключения

Тип исключения Условие
System.Runtime.InteropServices.COMException Это исключение можно получить по одной из следующих причин:
  • Указанный объект производительности не найден на компьютере. Значение Err.Number равно 0xC0000BB8.
  • Не удалось найти указанный счетчик. Значение Err.Number равно 0xC0000BB9.

Комментарии

Если в параметре pathname указать счетчик с подстановочными знаками, метод Add создает один объект CounterItem для каждого развернутого пути. Затем метод Add возвращает указатель на первый добавленный CounterItem.

Если подстановочный знак приведет к дубликату счетчика, ошибка не сообщается и дубликаты не создаются. Если до создания всех счетчиков возникает ошибка, сообщается об ошибке, а остальные счетчики не создаются.

Количество счетчиков, которые можно добавить, не ограничено; однако SYSMON будет на графе только первые 1024 счетчика в коллекции. Количество счетчиков, отображаемых SYSMON в отчете, не ограничено.

Чтобы получать уведомления при добавлении счетчика, реализуйте событие OnCounterAdded .

Требования

Требование Значение
Минимальная версия клиента
Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
Windows 2000 Server [только классические приложения]
DLL
Sysmon.ocx

См. также раздел

CounterItem

Counters

SystemMonitor.BrowseCounters