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