DllInstall, fonction (shlwapi.h)

Article
03/04/2024

Gère l’installation et la configuration d’une DLL.

Syntaxe

HRESULT DllInstall(
                 BOOL   bInstall,
  [in, optional] PCWSTR pszCmdLine
);

Paramètres

bInstall

Type : BOOL

TRUE si la DLL est en cours d’installation ; FALSE s’il est désinstallé.

[in, optional] pszCmdLine

Type : PCWSTR

Chaîne transmise par regsvr32 qui indique la procédure d’installation à utiliser. Cette valeur peut être NULL.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette fonction peut être implémentée et exportée par nom par une DLL pour une utilisation lors de l’installation ou de l’installation de l’application. Il est appelé par regsvr32 pour permettre à la DLL d’effectuer des tâches telles que l’ajout d’informations au Registre.

DllInstall est utilisé uniquement pour l’installation et l’installation de l’application. Il ne doit pas être appelé par une application. Son objectif est similaire à DllRegisterServer ou DllUnregisterServer. Contrairement à ces fonctions, DllInstall prend une chaîne d’entrée qui peut être utilisée pour spécifier diverses actions différentes. Cela permet d’installer une DLL de plusieurs façons, selon tous les critères appropriés.

Pour utiliser DllInstall avec regsvr32, ajoutez un indicateur « /i » suivi d’un signe deux-points (:) et d’une chaîne). La chaîne est passée à DllInstall en tant que paramètre pszCmdLine . Si vous omettez les deux-points et la chaîne, pszCmdLine aura la valeur NULL. L’exemple suivant est utilisé pour installer une DLL.

regsvr32 /i :"Install_1 » dllname.dll

DllInstall est appelé avec bInstall défini sur TRUE et pszCmdLine défini sur « Install_1 ». Pour désinstaller une DLL, utilisez les éléments suivants :

regsvr32 /u /i :"Install_1 » dllname.dll

Dans les deux exemples ci-dessus, DllRegisterServer ou DllUnregisterServer seront également appelés. Pour appeler DllInstall uniquement, ajoutez un indicateur « /n ».

regsvr32 /n /i :"Install_1 » dllname.dll

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlwapi.h
DLL	Shlwapi.dll (version 4.71 ou ultérieure)

Partager via