Funzione PdhParseCounterPathA (pdh.h)

Articolo
11/20/2024

Analizza gli elementi del percorso del contatore e archivia i risultati nella struttura PDH_COUNTER_PATH_ELEMENTS.

Sintassi

PDH_FUNCTION PdhParseCounterPathA(
  [in]      LPCSTR                       szFullPathBuffer,
  [out]     PPDH_COUNTER_PATH_ELEMENTS_A pCounterPathElements,
  [in, out] LPDWORD                      pdwBufferSize,
            DWORD                        dwFlags
);

Parametri

[in] szFullPathBuffer

nullstringa con terminazione contenente il percorso del contatore da analizzare. La lunghezza massima di un percorso del contatore è PDH_MAX_COUNTER_PATH.

[out] pCounterPathElements

Buffer allocato dal chiamante che riceve una struttura PDH_COUNTER_PATH_ELEMENTS. La struttura contiene puntatori ai singoli elementi stringa del percorso a cui fa riferimento il parametro szFullPathBuffer. La funzione aggiunge le stringhe alla fine della struttura PDH_COUNTER_PATH_ELEMENTS. Il buffer allocato deve essere sufficientemente grande per la struttura e le stringhe. Impostare su NULL se pdwBufferSize è zero.

[in, out] pdwBufferSize

Dimensioni del buffer pCounterPathElements in byte. Se zero in ingresso, la funzione restituisce PDH_MORE_DATA e imposta questo parametro sulla dimensione del buffer richiesta. Se il buffer è maggiore delle dimensioni necessarie, la funzione imposta questo parametro sulle dimensioni effettive del buffer utilizzato. Se la dimensione specificata per l'input è maggiore di zero ma minore della dimensione richiesta, non è consigliabile basarsi sulle dimensioni restituite per riallocare il buffer.

dwFlags

Riservato. Deve essere zero.

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_INVALID_ARGUMENT	Parametro non valido.
PDH_MORE_DATA	Il buffer pCounterPathElements è troppo piccolo per contenere gli elementi del percorso. Questo valore restituito è previsto se pdwBufferSize è zero all'input. Se la dimensione specificata per l'input è maggiore di zero ma minore della dimensione richiesta, non è consigliabile basarsi sulle dimensioni restituite per riallocare il buffer.
PDH_INVALID_PATH	Il percorso non è formattato correttamente e non può essere analizzato. Ad esempio, in alcune versioni è possibile ricevere questo errore se la dimensione specificata per l'input è maggiore di zero, ma minore della dimensione richiesta.
PDH_MEMORY_ALLOCATION_FAILURE	Impossibile allocare memoria per completare la funzione.

Osservazioni

È necessario chiamare questa funzione due volte, la prima volta per ottenere le dimensioni del buffer necessarie (impostare pCounterPathElements su NULL e pdwBufferSize su 0) e la seconda volta per ottenere i dati.

Nota

L'intestazione pdh.h definisce PdhParseCounterPath 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

Vedere anche

PDH_COUNTER_PATH_ELEMENTS

PdhMakeCounterPath

Condividi tramite