Condividi tramite


Counters.Add, metodo

Aggiunge un'istanza CounterItem all'insieme.

Sintassi

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

Parametri

pathname [in]

Percorso del contatore. Il percorso può includere un nome di computer e deve includere un nome di oggetto prestazioni, un nome di istanza dell'oggetto se l'oggetto prestazioni specificato supporta più istanze e un nome del contatore. Questa specifica del percorso non fa distinzione tra maiuscole e minuscole.

Per informazioni dettagliate sulla specifica di un percorso del contatore, vedere Specifica di un percorso contatore.

Eccezioni

Tipo di eccezione Condizione
System.Runtime.InteropServices.COMException È possibile ricevere questa eccezione per uno dei motivi seguenti:
  • L'oggetto prestazioni specificato non è stato trovato nel computer. Il valore Err.Number è 0xC0000BB8.
  • Impossibile trovare il contatore specificato. Il valore Err.Number è 0xC0000BB9.

Commenti

Se si specifica un contatore con caratteri jolly nel parametro pathname , il metodo Add crea un oggetto CounterItem per ogni percorso espanso. Il metodo Add restituisce quindi un puntatore al primo counteritem aggiunto.

Se il carattere jolly genera un contatore duplicato, l'errore non viene segnalato e non viene creato alcun duplicato. Se si verifica una condizione di errore prima della creazione di tutti i contatori, viene segnalato l'errore e i contatori rimanenti non vengono creati.

Non esiste alcun limite al numero di contatori che è possibile aggiungere; TUTTAVIA, SYSMON grafo solo i primi 1.024 contatori nella raccolta. Non esiste alcun limite al numero di contatori che SYSMON visualizzerà in un report.

Per ricevere una notifica quando viene aggiunto un contatore, implementare l'evento OnCounterAdded .

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional [solo app desktop]
Server minimo supportato
Windows 2000 Server [solo app desktop]
DLL
Sysmon.ocx

Vedi anche

CounterItem

Contatori

SystemMonitor.BrowseCounters