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:
|
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 |
|