PdhValidatePathA, fonction (pdh.h)

Vérifie que le compteur est présent sur l’ordinateur spécifié dans le chemin du compteur.

Syntaxe

PDH_FUNCTION PdhValidatePathA(
  [in] LPCSTR szFullPathBuffer
);

Paramètres

[in] szFullPathBuffer

Chaîne terminée par null qui contient le chemin d’accès du compteur à valider. La longueur maximale d’un chemin d’accès de compteur est PDH_MAX_COUNTER_PATH.

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

Retourner le code	Description
PDH_CSTATUS_NO_INSTANCE	L’instance spécifiée de l’objet de performance n’a pas été trouvée.
PDH_CSTATUS_NO_COUNTER	Le compteur spécifié n’a pas été trouvé dans l’objet de performance.
PDH_CSTATUS_NO_OBJECT	L’objet de performances spécifié n’a pas été trouvé sur l’ordinateur.
PDH_CSTATUS_NO_MACHINE	L’ordinateur spécifié n’a pas pu être trouvé ou connecté.
PDH_CSTATUS_BAD_COUNTERNAME	Impossible d’analyser la chaîne de chemin d’accès du compteur.
PDH_MEMORY_ALLOCATION_FAILURE	La fonction n’est pas en mesure d’allouer une mémoire tampon temporaire requise.

Remarques

Note

L’en-tête pdh.h définit PdhValidatePath 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

PdhMakeCounterPath