Funzione PdhVbAddCounter

La funzione PdhVbAddCounter crea una voce di contatore nell'oggetto query specificato e restituisce un handle a tale contatore al termine del completamento.

Importante

La funzione descritta in questo argomento può essere modificata o non disponibile in futuro. Microsoft consiglia invece di usare le funzioni descritte in Funzioni contatori delle prestazioni.

Funzione PdhVbAddCounter( _ ByVal QueryHandle As Long, _ ByVal CounterPath As String, _ ByVal CounterHandle as Long _ )

Parametri

QueryHandle

ID della query a cui deve essere assegnato questo contatore. Questo valore viene restituito dalla funzione PdhVbOpenQuery .

CounterPath

Stringa di testo che specifica il nome del percorso del contatore da aggiungere alla query. Il contenuto di questa stringa deve essere un percorso di contatore valido, come ottenuto dal browser del contatore o da un'altra origine.

CounterHandle

Riferimento univoco che identifica questo contatore nella query. Questa variabile deve essere inizializzata su zero prima che venga chiamata la funzione. Contiene un valore valido solo se la funzione viene completata correttamente.

Valore restituito

Se la funzione ha esito positivo, restituisce un intero long uguale a ERROR_SUCCESS e un nuovo handle nella variabile CounterHandle .

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema o un codice di errore PDH. Di seguito sono riportati i valori possibili.

Codice restituito	Descrizione
PDH_INVALID_ARGUMENT	Uno o più argomenti non sono validi o non corretti.
PDH_MEMORY_ALLOCATION_FAILURE	Impossibile allocare un buffer di memoria.
PDH_INVALID_HANDLE	L'handle di query non è valido.
PDH_CSTATUS_NO_COUNTER	Il contatore specificato non è stato trovato.
PDH_CSTATUS_NO_OBJECT	Impossibile trovare l'oggetto specificato.
PDH_CSTATUS_NO_MACHINE	Impossibile creare una voce del computer.
PDH_CSTATUS_BAD_COUNTERNAME	È stata passata una stringa di percorso del nome del contatore vuota.
PDH_FUNCTION_NOT_FOUND	Impossibile determinare la funzione di calcolo per questo contatore.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Libreria	Pdh.lib
DLL	Pdh.dll

Vedi anche

PdhVbOpenQuery