Fonction LoadPerfCounterTextStringsW (loadperf.h)

Article
11/20/2024

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

Syntaxe

LOADPERF_FUNCTION LoadPerfCounterTextStringsW(
  [in] LPWSTR 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 de ligne de commande peut être « xx myfile.ini». Les lettres avant l’espace (ici « xx ») sont ignorées, et la deuxième partie, qui suit l’espace, est interprétée comme la spécification du fichier d’initialisation.

[in] bQuietModeArg

Affectez la valeur 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 de retour

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 aux fonctionnalités fournies par l’outil Lodctr. Pour plus d’informations sur Lodctr, consultez Ajout de noms de compteurs et de descriptions au registre.

Note

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. 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	loadperf.h
bibliothèque	Loadperf.lib
DLL	Loadperf.dll

Voir aussi

UnloadPerfCounterTextStrings

Partager via