PdhOpenQueryA, fonction (pdh.h)

Article
08/25/2023

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 PdhOpenQueryA(
  [in]  LPCSTR     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.

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.

Spécifications


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

Voir aussi

PdhSetDefaultRealTimeDataSource