Метод Counters.Add

Статья
06/13/2023

Добавляет экземпляр 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

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