Funzione PdhValidatePathA (pdh.h)
Verifica che il contatore sia presente nel computer specificato nel percorso del contatore.
Sintassi
PDH_FUNCTION PdhValidatePathA(
[in] LPCSTR szFullPathBuffer
);
Parametri
[in] szFullPathBuffer
Stringa con terminazione Null contenente il percorso del contatore da convalidare. La lunghezza massima di un percorso del contatore è PDH_MAX_COUNTER_PATH.
Valore restituito
Se la funzione ha esito positivo, restituisce 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 |
|---|---|
|
L'istanza specificata dell'oggetto prestazioni non è stata trovata. |
|
Il contatore specificato non è stato trovato nell'oggetto prestazioni. |
|
L'oggetto prestazioni specificato non è stato trovato nel computer. |
|
Impossibile trovare o connettere il computer specificato. |
|
Impossibile analizzare la stringa del percorso del contatore. |
|
La funzione non è in grado di allocare un buffer temporaneo necessario. |
Osservazioni
Nota
L'intestazione pdh.h definisce PdhValidatePath come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows XP [solo app desktop] |
| server minimo supportato | Windows Server 2003 [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione |
pdh.h |
| libreria |
Pdh.lib |
| dll | Pdh.dll |