PdhValidatePathW, fonction (pdh.h)
Valide que le compteur est présent sur l’ordinateur spécifié dans le chemin du compteur.
Syntaxe
PDH_FUNCTION PdhValidatePathW(
[in] LPCWSTR szFullPathBuffer
);
Paramètres
[in] szFullPathBuffer
Chaîne terminée par null qui contient 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 |
|---|---|
|
Le instance spécifié de l’objet de performance est introuvable. |
|
Le compteur spécifié n’a pas été trouvé dans l’objet de performance. |
|
L’objet de performances spécifié est introuvable sur l’ordinateur. |
|
L’ordinateur spécifié est introuvable ou connecté. |
|
Impossible d’analyser la chaîne de chemin du compteur. |
|
La fonction ne peut pas allouer une mémoire tampon temporaire requise. |
Remarques
Notes
L’en-tête pdh.h définit PdhValidatePath 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 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 |