Partager via


PdhOpenQueryW, 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 PdhOpenQueryW(
  [in]  LPCWSTR    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

Voir aussi

PdhCloseQuery

PdhGetCounterInfo

PdhIsRealTimeQuery

PdhOpenQueryH

PdhSetDefaultRealTimeDataSource