Partager via

PdhValidatePathExW, fonction (pdh.h)

  • Article

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

Syntaxe

PDH_FUNCTION PdhValidatePathExW(
  [in, optional] PDH_HLOG hDataSource,
  [in]           LPCWSTR  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 renvoyée 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é 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 ou dans le fichier journal.
PDH_CSTATUS_NO_MACHINE
 L’ordinateur spécifié est introuvable ou connecté.
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 comme un 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.

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