Funzione PdhOpenQueryA (pdh.h)
Crea una nuova query utilizzata per gestire la raccolta di dati sulle prestazioni.
Per usare handle per le origini dati, usare la funzione PdhOpenQueryH
Sintassi
PDH_FUNCTION PdhOpenQueryA(
[in] LPCSTR szDataSource,
[in] DWORD_PTR dwUserData,
[out] PDH_HQUERY *phQuery
);
Parametri
[in] szDataSource
Nullstringa con terminazione che specifica il nome del file di log da cui recuperare i dati sulle prestazioni. Se NULL, i dati sulle prestazioni vengono raccolti da un'origine dati in tempo reale.
[in] dwUserData
Valore definito dall'utente da associare a questa query. Per recuperare i dati utente in un secondo momento, chiamare PdhGetCounterInfo e accedere al membro dwQueryUserData di PDH_COUNTER_INFO.
[out] phQuery
Handle per la query. Questo handle viene usato nelle chiamate successive.
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 .
Osservazioni
Nota
L'intestazione pdh.h definisce PdhOpenQuery 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 |