PdhLookupPerfIndexByNameA, fonction (pdh.h)

Retourne l’index de compteur correspondant au nom de compteur spécifié.

Syntaxe

PDH_FUNCTION PdhLookupPerfIndexByNameA(
  [in]  LPCSTR  szMachineName,
  [in]  LPCSTR  szNameBuffer,
  [out] LPDWORD pdwIndex
);

Paramètres

[in] szMachineName

Chaîne terminée par null qui spécifie le nom de l’ordinateur où se trouve le compteur spécifié. Le nom de l’ordinateur peut être spécifié par le nom DNS ou l’adresse IP. Si la valeur est NULL, la fonction utilise l’ordinateur local.

[in] szNameBuffer

Chaîne terminée par null qui contient le nom du compteur.

[out] pdwIndex

Index du compteur.

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 une valeur possible.

Code de retour	Description
PDH_INVALID_ARGUMENT	Un paramètre n’est pas valide ou est mal mis en forme.

Remarques

Notes

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

Voir aussi

PdhLookupPerfNameByIndex