Funzione PdhValidatePathExW (pdh.h)

Articolo
11/20/2024

Verifica che il contatore specificato sia presente nel computer o nel file di log.

Sintassi

PDH_FUNCTION PdhValidatePathExW(
  [in, optional] PDH_HLOG hDataSource,
  [in]           LPCWSTR  szFullPathBuffer
);

Parametri

[in, optional] hDataSource

Handle per l'origine dati. Le funzioni PdhOpenLog e PdhBindInputDataSource restituiscono questo handle.

Per verificare che il contatore sia presente nel computer locale, specificare NULL (equivale a chiamare PdhValidatePath).

[in] szFullPathBuffer

nullstringa con terminazione che specifica 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
PDH_CSTATUS_NO_INSTANCE	L'istanza specificata dell'oggetto prestazioni non è stata trovata.
PDH_CSTATUS_NO_COUNTER	Il contatore specificato non è stato trovato nell'oggetto prestazioni.
PDH_CSTATUS_NO_OBJECT	L'oggetto prestazioni specificato non è stato trovato nel computer o nel file di log.
PDH_CSTATUS_NO_MACHINE	Impossibile trovare o connettere il computer specificato.
PDH_CSTATUS_BAD_COUNTERNAME	Impossibile analizzare la stringa del percorso del contatore.
PDH_MEMORY_ALLOCATION_FAILURE	La funzione non è in grado di allocare un buffer temporaneo necessario.

Osservazioni

Nota

L'intestazione pdh.h definisce PdhValidatePathEx 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 Vista [solo app desktop]
server minimo supportato	Windows Server 2008 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	pdh.h
libreria	Pdh.lib
dll	Pdh.dll

Vedere anche

PdhMakeCounterPath

PdhValidatePath

Condividi tramite