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 将仅绘制集合中的前 1，024 个计数器。 SYSMON 将在报表中显示的计数器数量没有限制。

若要在添加计数器时接收通知，请实现 OnCounterAdded 事件。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
DLL	Sysmon.ocx