InstallPerfDllA, fonction (loadperf.h)

Article
11/20/2024

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

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

Syntaxe

LOADPERF_FUNCTION InstallPerfDllA(
  [in] LPCSTR    szComputerName,
  [in] LPCSTR    lpIniFile,
  [in] ULONG_PTR dwFlags
);

Paramètres

[in] szComputerName

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

[in] lpIniFile

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

[in] dwFlags

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

Valeur de retour

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 qui a provoqué l’échec.

Remarques

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

Note

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. 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
plateforme cible	Windows
d’en-tête	loadperf.h
DLL	Loadperf.dll

Voir aussi

LoadPerfCounterTextStrings

Partager via