Counters.Add-Methode

Fügt der Auflistung eine CounterItem-Instanz hinzu.

Syntax

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

Parameter

pathname [ In]

Pfad zum Zähler. Der Pfad kann einen Computernamen enthalten und muss einen Leistungsobjektnamen, einen Objektinstanznamen, wenn das angegebene Leistungsobjekt mehrere Instanzen unterstützt, und einen Indikatornamen enthalten. Bei dieser Pfadspezifikation wird die Kleinschreibung nicht beachtet.

Weitere Informationen zum Angeben eines Indikatorpfads finden Sie unter Angeben eines Indikatorpfads.

Ausnahmen

Ausnahmetyp Bedingung
System.Runtime.InteropServices.COMException Sie können diese Ausnahme aus einem der folgenden Gründe erhalten:
  • Das angegebene Leistungsobjekt wurde auf dem Computer nicht gefunden. Der Err.Number-Wert ist 0xC0000BB8.
  • Der angegebene Zähler wurde nicht gefunden. Der Err.Number-Wert ist 0xC0000BB9.

Hinweise

Wenn Sie einen Platzhalterzähler im Pathname-Parameter angeben, erstellt die Add-Methode ein CounterItem-Objekt für jeden erweiterten Pfad. Die Add-Methode gibt dann einen Zeiger auf das erste hinzugefügte CounterItem zurück.

Wenn der Platzhalter zu einem doppelten Leistungsindikator führen würde, wird der Fehler nicht gemeldet, und es wird kein Duplikat erstellt. Wenn eine Fehlerbedingung auftritt, bevor alle Leistungsindikatoren erstellt werden, wird der Fehler gemeldet, und die verbleibenden Leistungsindikatoren werden nicht erstellt.

Es gibt keine Beschränkung für die Anzahl von Leistungsindikatoren, die Sie hinzufügen können. SYSMON zeigt jedoch nur die ersten 1.024 Leistungsindikatoren in der Auflistung an. Es gibt keine Beschränkung für die Anzahl der Leistungsindikatoren, die SYSMON in einem Bericht anzeigen wird.

Implementieren Sie das OnCounterAdded-Ereignis, um Benachrichtigungen zu erhalten, wenn ein Zähler hinzugefügt wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
DLL
Sysmon.ocx

Weitere Informationen

CounterItem

Counters

SystemMonitor.BrowseCounters