PdhGetRawCounterValue, fonction (pdh.h)
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 |
|---|---|
|
Un paramètre n’est pas valide ou est mal mis en forme. |
|
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 |