Função DllInstall (shlwapi.h)

Manipula a instalação e a instalação de uma DLL.

Sintaxe

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

Parâmetros

bInstall

Tipo: BOOL

TRUE se a DLL estiver sendo instalada; FALSE se ele estiver sendo desinstalado.

[in, optional] pszCmdLine

Tipo: PCWSTR

Uma cadeia de caracteres passada por regsvr32 que indica qual procedimento de instalação usar. Esse valor pode ser NULL.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Essa função pode ser implementada e exportada pelo nome por uma DLL para uso durante a instalação ou instalação do aplicativo. Ele é invocado pelo regsvr32 para permitir que a DLL execute tarefas como adicionar informações ao registro.

DllInstall é usado apenas para instalação e instalação do aplicativo. Ele não deve ser chamado por um aplicativo. É semelhante em finalidade a DllRegisterServer ou DllUnregisterServer. Ao contrário dessas funções, dllInstall usa uma cadeia de caracteres de entrada que pode ser usada para especificar uma variedade de ações diferentes. Isso permite que uma DLL seja instalada de mais de uma maneira, com base em qualquer critério apropriado.

Para usar DllInstall com regsvr32, adicione um sinalizador "/i" seguido de dois-pontos (:) e uma cadeia de caracteres. A cadeia de caracteres será passada para DllInstall como o parâmetro pszCmdLine . Se você omitir dois-pontos e cadeia de caracteres, pszCmdLine será definido como NULL. O exemplo a seguir seria usado para instalar uma DLL.

regsvr32 /i:"Install_1" dllname.dll

DllInstall é invocado com bInstall definido como TRUE e pszCmdLine definido como "Install_1". Para desinstalar uma DLL, use o seguinte:

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

Com ambos os exemplos acima, DllRegisterServer ou DllUnregisterServer também serão chamados. Para chamar somente DllInstall , adicione um sinalizador "/n".

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h
DLL	Shlwapi.dll (versão 4.71 ou posterior)