PdhOpenQueryA, fonction (pdh.h)
Crée une requête utilisée pour gérer la collecte de données de performances.
Pour utiliser des handles vers des sources de données, utilisez la fonction PdhOpenQueryH.
Syntaxe
PDH_FUNCTION PdhOpenQueryA(
[in] LPCSTR szDataSource,
[in] DWORD_PTR dwUserData,
[out] PDH_HQUERY *phQuery
);
Paramètres
[in] szDataSource
chaîne null-terminated qui spécifie le nom du fichier journal à partir duquel récupérer des données de performances. Si NULL, les données de performances sont collectées à partir d’une source de données en temps réel.
[in] dwUserData
Valeur définie par l’utilisateur à associer à cette requête. Pour récupérer les données utilisateur ultérieurement, appelez PdhGetCounterInfo et accédez au membre dwQueryUserData de PDH_COUNTER_INFO.
[out] phQuery
Gérer la requête. Vous utilisez ce handle dans les appels suivants.
Valeur de retour
Si la fonction réussit, elle retourne ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour est un code d’erreur système ou un code d’erreur PDH .
Remarques
Note
L’en-tête pdh.h définit PdhOpenQuery comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | pdh.h |
| bibliothèque | Pdh.lib |
| DLL | Pdh.dll |