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