PdhGetRawCounterValue, fonction (pdh.h)

  • Article

Retourne la valeur brute actuelle du compteur.

Syntaxe

PDH_FUNCTION PdhGetRawCounterValue(
  [in]  PDH_HCOUNTER     hCounter,
  [out] LPDWORD          lpdwType,
  [out] PPDH_RAW_COUNTER pValue
);

Paramètres

[in] hCounter

Handle du compteur à partir duquel récupérer la valeur brute actuelle. La fonction PdhAddCounter retourne ce handle.

[out] lpdwType

Reçoit le type de compteur. Pour obtenir la liste des types de compteurs, consultez la section Types de compteurs du Kit de déploiement Windows Server 2003. Ce paramètre est facultatif.

[out] pValue

Structure PDH_RAW_COUNTER qui reçoit la valeur du compteur.

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. Voici les valeurs possibles.

Code de retour Description
PDH_INVALID_ARGUMENT
 Un paramètre n’est pas valide ou est mal mis en forme.
PDH_INVALID_HANDLE
 Le handle de compteur n’est pas valide.

Remarques

Les données du compteur sont verrouillées (protégées) pendant la durée de l’appel à PdhGetRawCounterValue afin d’empêcher toute modification pendant le traitement de l’appel.

Si le instance de compteur spécifié n’existe pas, cette fonction retourne ERROR_SUCCESS et le membre CStatus de la structure PDH_RAW_COUNTER contient PDH_CSTATUS_NO_INSTANCE.

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

Voir aussi

PdhCalculateCounterFromRawValue

PdhCollectQueryData

PdhGetFormattedCounterValue