Partager via


Fonction LoadPerfCounterTextStringsA (loadperf.h)

Charge sur l’ordinateur les objets de performance et les compteurs définis dans le fichier d’initialisation spécifié.

Syntaxe

LOADPERF_FUNCTION LoadPerfCounterTextStringsA(
  [in] LPSTR lpCommandLine,
  [in] BOOL  bQuietModeArg
);

Paramètres

[in] lpCommandLine

Chaîne terminée par null qui se compose d’une ou plusieurs lettres arbitraires, d’un espace, puis du nom du fichier d’initialisation (.ini). Le nom peut inclure le chemin d’accès au fichier d’initialisation.

La fonction utilise uniquement le fichier d’initialisation ; le premier argument est ignoré. Par exemple, pour charger un fichier d’initialisation appelé « myfile.ini », la chaîne commandLine peut être « xx myfile.ini ». Les lettres avant l’espace (ici « xx ») sont ignorées, et la deuxième partie, après l’espace, est interprétée comme la spécification du fichier d’initialisation.

[in] bQuietModeArg

Définissez sur TRUE pour empêcher la fonction d’afficher la sortie de l’outil Lodctr ; sinon, FALSE. Ce paramètre a une signification uniquement si l’application est exécutée à partir d’une invite de commandes.

Valeur retournée

Si la fonction réussit, elle retourne ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur système.

Remarques

Cette fonction fournit une API à la fonctionnalité fournie par l’outil Lodctr . Pour plus d’informations sur Lodctr, consultez Ajout de noms et de descriptions de compteurs au Registre.

Notes

L’en-tête loadperf.h définit LoadPerfCounterTextStrings 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 loadperf.h
Bibliothèque Loadperf.lib
DLL Loadperf.dll

Voir aussi

UnloadPerfCounterTextStrings