Vérification des codes d’état des données du compteur

La valeur de retour des fonctions PDH indique la réussite ou l’échec de l’appel de fonction, ce qui est différent de la status des données du compteur. Toujours case activée le membre CStatus d’une valeur de compteur retournée dans les structures PDH pour vous assurer que les données retournées sont valides avant de les utiliser. Si la valeur du membre CStatus n’indique pas la réussite, n’utilisez pas les données. Voici les valeurs status possibles pour les compteurs :

Valeur	Signification
PDH_CSTATUS_NO_MACHINE	PDH n’a pas pu se connecter à l’ordinateur spécifié dans le chemin du compteur. Si cette status est retournée lors de l’ajout du compteur, le compteur n’est pas complètement initialisé. Chaque fois que la requête est mise à jour, PDH retente la connexion. Une fois la connexion établie, la collecte de données normale reprend.
PDH_CSTATUS_NO_OBJECT	L’ordinateur spécifié a été trouvé, mais l’objet de performance spécifié a été trouvé sur l’ordinateur. Si cette status est retournée lors de l’ajout du compteur, le compteur spécifié n’est pas inclus dans la requête. Si cette status est retournée par un compteur actif, les données de ce compteur ne sont pas valides. Chaque fois que les données sont demandées, PDH tente d’obtenir ces données de compteur.
PDH_CSTATUS_NO_INSTANCE	Le instance spécifié est introuvable dans l’objet . Si cette status est retournée pendant l’ajout du compteur à la requête, le compteur est correctement ajouté à la requête, mais aucune donnée n’est disponible tant que le instance spécifique n’apparaît pas et qu’une status réussie n’est pas retournée.
PDH_CSTATUS_NO_COUNTER	Le compteur spécifié n’a pas été trouvé dans l’objet spécifié. Si cette status est retournée lors de l’ajout du compteur, le compteur n’est pas ajouté à la requête. Si cette status est retournée après la collecte des données, les données de ce compteur ne sont pas valides. Chaque fois que les données sont demandées, PDH tente d’obtenir ces données de compteur.
PDH_CSTATUS_INVALID_DATA	Le compteur a été trouvé, mais les données retournées ne sont pas valides. Cette erreur peut se produire si la valeur du compteur est inférieure à la valeur précédente. (Étant donné que les valeurs de compteur sont toujours incrémentées, la valeur du compteur passe à zéro lorsqu’elle atteint sa valeur maximale.) Une autre cause possible est un minuteur système qui n’est pas correct.
PDH_CSTATUS_VALID_DATA	Les données du compteur ont été retournées avec succès, mais sont inchangées par rapport à la dernière lecture du compteur.
PDH_CSTATUS_NEW_DATA	Les données du compteur ont été retournées correctement et sont différentes de la dernière fois que le compteur a été lu. PDH_CSTATUS_NEW_DATA peut être retourné sur un compteur de taux même si le taux résultant est identique à celui du dernier échantillon. En effet, la valeur des données brutes utilisée dans la détermination de cette valeur status a changé, et non le taux calculé.
PDH_MORE_DATA	La mémoire tampon fournie n’était pas assez grande pour stocker toutes les données du compteur. Allouez une mémoire tampon plus grande et réexécutez la fonction.
PDH_CSTATUS_ITEM_NOT_VALIDATED	Le compteur a été ajouté à la requête, mais n’a pas été validé ni accédé. Aucune autre information status sur ce compteur n’est disponible.
PDH_CSTATUS_NO_COUNTERNAME	Aucun nom de compteur n’a été spécifié dans la requête.
PDH_CSTATUS_NO_COUNTER	Le nom du compteur spécifié est introuvable.
PDH_CSTATUS_NO_OBJECT	L’objet de performances spécifié est introuvable.
PDH_CALC_NEGATIVE_DENOMINATOR	Un compteur a une valeur de dénominateur négative.
PDH_CALC_NEGATIVE_TIMEBASE	Un compteur a une valeur de base de temps négative.
PDH_CALC_NEGATIVE_VALUE	Un compteur a une valeur négative.
PDH_CSTATUS_NO_COUNTERNAME	Aucun chemin de compteur n’a été spécifié.
PDH_CSTATUS_BAD_COUNTERNAME	Le format du chemin d’accès du compteur est incorrect.