PdhValidatePathExA, fonction (pdh.h)

Article
03/04/2024

Vérifie que le compteur spécifié est présent sur l’ordinateur ou dans le fichier journal.

Syntaxe

PDH_FUNCTION PdhValidatePathExA(
  [in, optional] PDH_HLOG hDataSource,
  [in]           LPCSTR   szFullPathBuffer
);

Paramètres

[in, optional] hDataSource

Gérer vers la source de données. Les fonctions PdhOpenLog et PdhBindInputDataSource retournent ce handle.

Pour vérifier que le compteur est présent sur l’ordinateur local, spécifiez NULL (cela revient à appeler PdhValidatePath).

[in] szFullPathBuffer

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

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_CSTATUS_NO_INSTANCE	Le instance spécifié de l’objet de performance est introuvable.
PDH_CSTATUS_NO_COUNTER	Le compteur spécifié est introuvable dans l’objet de performance.
PDH_CSTATUS_NO_OBJECT	L’objet de performance spécifié est introuvable sur l’ordinateur ou dans le fichier journal.
PDH_CSTATUS_NO_MACHINE	Impossible de trouver ou de connecter l’ordinateur spécifié.
PDH_CSTATUS_BAD_COUNTERNAME	Impossible d’analyser la chaîne de chemin du compteur.
PDH_MEMORY_ALLOCATION_FAILURE	La fonction ne peut pas allouer une mémoire tampon temporaire requise.

Remarques

Notes

L’en-tête pdh.h définit PdhValidatePathEx en tant qu’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. La combinaison 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.

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

PdhMakeCounterPath

PdhValidatePath

Partager via