PdhLookupPerfIndexByNameA, fonction (pdh.h)

Article
11/20/2024

Retourne l’index du 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 null-terminated 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 NULL, la fonction utilise l’ordinateur local.

[in] szNameBuffer

chaîne null-terminated qui contient le nom du compteur.

[out] pdwIndex

Index du compteur.

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

Retourner le code	Description
PDH_INVALID_ARGUMENT	Un paramètre n’est pas valide ou n’est pas correctement mis en forme.

Remarques

Note

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. 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

PdhLookupPerfNameByIndex

Partager via