PdhOpenQueryW, fonction (pdh.h)
Crée une requête qui est utilisée pour gérer la collecte de données de performances.
Pour utiliser des handles dans des sources de données, utilisez la fonction PdhOpenQueryH .
Syntaxe
PDH_FUNCTION PdhOpenQueryW(
[in] LPCWSTR szDataSource,
[in] DWORD_PTR dwUserData,
[out] PDH_HQUERY *phQuery
);
Paramètres
[in] szDataSource
Chaîne terminée par null qui spécifie le nom du fichier journal à partir duquel récupérer les données de performances. Si la valeur est 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 retournée
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
Notes
L’en-tête pdh.h définit PdhOpenQuery en tant qu’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. La combinaison 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | pdh.h |
| Bibliothèque | Pdh.lib |
| DLL | Pdh.dll |