Fonction PdhCollectQueryDataWithTime (pdh.h)

Article
03/01/2024

Collecte la valeur de données brutes actuelle pour tous les compteurs de la requête spécifiée et met à jour le code status de chaque compteur.

Syntaxe

PDH_FUNCTION PdhCollectQueryDataWithTime(
  [in, out] PDH_HQUERY hQuery,
  [out]     LONGLONG   *pllTimeStamp
);

Paramètres

[in, out] hQuery

Gérer la requête pour laquelle vous souhaitez collecter des données. La fonction PdhOpenQuery retourne ce handle.

[out] pllTimeStamp

Horodatage lorsque la première valeur de compteur de la requête a été récupérée. L’heure est spécifiée comme FILETIME.

Valeur retournée

Si la fonction réussit, elle retourne ERROR_SUCCESS. Sinon, la fonction retourne un code d’erreur système ou un code d’erreur PDH.

Voici les valeurs possibles.

Code de retour	Description
PDH_INVALID_HANDLE	Le handle de requête n’est pas valide.
PDH_NO_DATA	La requête n’a actuellement aucun compteur.

Remarques

Appelez cette fonction lorsque vous souhaitez collecter des données de compteur pour les compteurs de la requête. PDH stocke les valeurs de compteur brutes pour la collection actuelle et précédente.

Si vous souhaitez récupérer la valeur actuelle du compteur brut, appelez la fonction PdhGetRawCounterValue . Si vous souhaitez calculer une valeur d’affichage pour la valeur du compteur, appelez pdhGetFormattedCounterValue. Si le chemin du compteur contient un caractère générique pour le nom instance, appelez les fonctions PdhGetRawCounterArray et PdhGetFormattedCounterArray, respectivement.

Lorsque PdhCollectQueryDataEx est appelé pour les données d’un seul compteur instance et que le compteur instance n’existe pas, la fonction retourne PDH_NO_DATA. Toutefois, si les données de plusieurs compteurs sont interrogées, PdhCollectQueryDataEx peut retourner ERROR_SUCCESS même si l’une des instances de compteur n’existe pas encore. Cela est dû au fait qu’il n’est pas connu si le compteur spécifié instance n’existe pas ou s’il existera mais n’a pas encore été créé. Dans ce cas, appelez la fonction PdhGetRawCounterValue ou PdhGetFormattedCounterValue pour chacune des instances de compteur intéressantes pour déterminer si elles existent.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	pdh.h
Bibliothèque	Pdh.lib
DLL	Pdh.dll

Voir aussi

PdhCollectQueryData

PdhGetFormattedCounterValue

PdhGetRawCounterValue

PdhOpenQuery

Partager via