Compartir a través de

Función DllInstall (shlwapi.h)

  • Artículo

Controla la instalación y configuración de un archivo DLL.

Sintaxis

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

Parámetros

bInstall

Tipo: BOOL

TRUE si se está instalando el archivo DLL; FALSE si se está desinstalando.

[in, optional] pszCmdLine

Tipo: PCWSTR

Cadena pasada por regsvr32 que indica qué procedimiento de instalación se va a usar. Este valor puede ser NULL.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Esta función se puede implementar y exportar por nombre por un archivo DLL para su uso durante la instalación o la instalación de la aplicación. Regsvr32 lo invoca para permitir que el archivo DLL realice tareas como agregar información al registro.

DllInstall solo se usa para la instalación y configuración de la aplicación. Una aplicación no debe llamar a ella. Es similar en propósito a DllRegisterServer o DllUnregisterServer. A diferencia de estas funciones, DllInstall toma una cadena de entrada que se puede usar para especificar una variedad de acciones diferentes. Esto permite instalar un archivo DLL de varias maneras, en función de los criterios adecuados.

Para usar DllInstall con regsvr32, agregue una marca "/i" seguida de dos puntos (:) y una cadena. La cadena se pasará a DllInstall como parámetro pszCmdLine . Si omite los dos puntos y la cadena, pszCmdLine se establecerá en NULL. En el ejemplo siguiente se usaría para instalar un archivo DLL.

regsvr32 /i:"Install_1" dllname.dll

DllInstall se invoca con bInstall establecido en TRUE y pszCmdLine establecido en "Install_1". Para desinstalar un archivo DLL, use lo siguiente:

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

Con los dos ejemplos anteriores, también se llamará a DllRegisterServer o DllUnregisterServer . Para llamar solo a DllInstall , agregue una marca "/n".

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

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlwapi.h
Archivo DLL Shlwapi.dll (versión 4.71 o posterior)