Counters.Add-Methode

Fügt der Auflistung ein CounterItem-instance hinzu.

Syntax

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

Parameter

pfadname [in]

Pfad zum Leistungsindikator. Der Pfad kann einen Computernamen enthalten und muss einen Leistungsobjektnamen, ein Objekt instance Namen enthalten, wenn das angegebene Leistungsobjekt mehrere Instanzen unterstützt, und einen Leistungsindikatornamen. Bei dieser Pfadspezifikation wird die Groß-/Kleinschreibung nicht beachtet.

Ausführliche 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 konnte nicht gefunden werden. Der Err.Number-Wert ist 0xC0000BB9.

Bemerkungen

Wenn Sie einen Wildcardzä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 Wildcard-Wert zu einem doppelten Zähler 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.

Die Anzahl der Indikatoren, die Sie hinzufügen können, ist nicht begrenzt. SYSMON graphisiert jedoch nur die ersten 1.024 Indikatoren in der Auflistung. Die Anzahl der Indikatoren, die SYSMON in einem Bericht anzeigt, ist nicht begrenzt.

Um eine Benachrichtigung zu erhalten, wenn ein Leistungsindikator hinzugefügt wird, implementieren Sie das OnCounterAdded-Ereignis .

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

Siehe auch

CounterItem

Counters

SystemMonitor.BrowseCounters