Condividi tramite

Funzione PdhVbGetCounterPathElements

  • Articolo

La funzione PdhVbGetCounterPathElements analizza una stringa di percorso del contatore delle prestazioni completa nei singoli elementi. Ognuna delle variabili stringa deve avere le stesse dimensioni (BufferSize) e dimensionata e inizializzata prima che venga usata in questa funzione.

Importante

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

Function PdhVbGetCounterPathElements( _ ByVal PathString As String, _ ByVal MachineName As String, _ ByVal ObjectName As String, _ ByVal InstanceName As String, _ ByVal ParentInstance As String, _ ByVal CounterName As String, _ ByVal BufferSize As Long _ ) As Long

Parametri

PathString

Stringa di percorso del contatore che deve essere suddivisa nei singoli elementi.

MachineName

Stringa per ricevere il nome del computer.

ObjectName

Stringa per ricevere il nome dell'oggetto.

InstanceName

Stringa per ricevere il nome dell'istanza, se usato.

ParentInstance

Stringa per ricevere l'istanza padre, se utilizzata.

CounterName

Stringa per ricevere il nome del contatore.

BufferSize

Dimensione massima di ogni variabile stringa usata come parametro per questa chiamata di funzione.

Valore restituito

Se la funzione ha esito positivo, restituisce un numero intero Long uguale a ERROR_SUCCESS.

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
 Una o più delle stringhe buffer non sono le dimensioni corrette.
PDH_MORE_DATA
 Uno o più elementi del percorso del contatore sono troppo grandi per la lunghezza del buffer restituito.
PDH_MEMORY_ALLOCATION_FAILURE
 Impossibile allocare un buffer di memoria temporaneo.

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

PdhVbCreateCounterPathList

PdhVbGetCounterPathFromList

PdhVbGetOneCounterPath