InstallPerfDllW, fonction (loadperf.h)

Article
02/28/2024

Installe des chaînes de compteur de performances, telles que définies dans un fichier d’entrée .ini, dans le registre système.

Note Microsoft recommande aux développeurs d’utiliser LoadPerfCounterTextStrings au lieu de InstallPerfDll. LoadPerfCounterTextStrings appelle InstallPerfDll en interne.

Syntaxe

LOADPERF_FUNCTION InstallPerfDllW(
  [in] LPCWSTR   szComputerName,
  [in] LPCWSTR   lpIniFile,
  [in] ULONG_PTR dwFlags
);

Paramètres

[in] szComputerName

Nom du système. Cette valeur doit être NULL , car cette fonction ne peut pas être utilisée pour l’installation à distance.

[in] lpIniFile

Nom du fichier d’initialisation qui contient les définitions à ajouter au Registre.

[in] dwFlags

Ce paramètre peut être LOADPERF_FLAGS_DISPLAY_USER_MSGS ((ULONG_PTR) 8).

Valeur retournée

Si la fonction réussit, elle retourne TRUE et publie des informations supplémentaires dans un journal des événements d’application. Sinon, elle retourne un code d’erreur qui représente la condition à l’origine de l’échec.

Remarques

Cette fonction n’a pas de bibliothèque d’importation associée ; vous devez l’appeler à l’aide des fonctions LoadLibrary et GetProcAddress .

Notes

L’en-tête loadperf.h définit InstallPerfDll en tant qu’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
Plateforme cible	Windows
En-tête	loadperf.h
DLL	Loadperf.dll

Voir aussi

LoadPerfCounterTextStrings

Partager via