Funzione PdhOpenQueryW (pdh.h)
Crea una nuova query usata per gestire la raccolta di dati sulle prestazioni.
Per usare handle per le origini dati, usare la funzione PdhOpenQueryH .
Sintassi
PDH_FUNCTION PdhOpenQueryW(
[in] LPCWSTR szDataSource,
[in] DWORD_PTR dwUserData,
[out] PDH_HQUERY *phQuery
);
Parametri
[in] szDataSource
Stringa con terminazione null 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
Gestire 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.
Commenti
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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | pdh.h |
| Libreria | Pdh.lib |
| DLL | Pdh.dll |