Função MsiSetExternalUIA (msi.h)
A função MsiSetExternalUI habilita um manipulador de interface do usuário externo. Esse manipulador de interface do usuário externo é chamado antes do manipulador de interface do usuário interno normal. O manipulador de interface do usuário externo tem a opção de suprimir a interface do usuário interna retornando um valor diferente de zero para indicar que ele lidou com as mensagens. Para obter mais informações, confira Sobre a interface do usuário.
Sintaxe
INSTALLUI_HANDLERA MsiSetExternalUIA(
[in] INSTALLUI_HANDLERA puiHandler,
[in] DWORD dwMessageFilter,
[in] LPVOID pvContext
);
Parâmetros
[in] puiHandler
Especifica uma função de retorno de chamada que está em conformidade com a especificação de INSTALLUI_HANDLER .
[in] dwMessageFilter
Especifica quais mensagens manipular usando o manipulador de mensagens externo. Se o manipulador externo retornar um resultado diferente de zero, essa mensagem não será enviada para a interface do usuário, em vez disso, a mensagem será registrada se o registro em log tiver sido habilitado. Para obter mais informações, consulte a função MsiEnableLog .
| Valor | Significado |
|---|---|
|
Arquivos em informações de uso. Quando essa mensagem é recebida, uma caixa de diálogo FilesInUse deve ser exibida. |
|
Término prematuro da instalação. |
|
As mensagens de erro são registradas. |
|
As mensagens de aviso são registradas. |
|
As solicitações do usuário são registradas. |
|
As mensagens status que não são exibidas são registradas. |
|
Solicitação para determinar um local de origem válido. |
|
Arquivos em informações de uso. Quando essa mensagem é recebida, uma caixa de diálogo MsiRMFilesInUse deve ser exibida. |
|
Não havia espaço suficiente no disco. |
|
O início de novas ações de instalação é registrado. |
|
O registro de dados com a ação de instalação é registrado em log. |
|
Os parâmetros para inicialização da interface do usuário são registrados. |
|
Informações da barra de progresso . Essa mensagem inclui informações sobre unidades até o momento e o número total de unidades. Para obter uma explicação do formato da mensagem, consulte a função MsiProcessMessage . Essa mensagem só é enviada para uma interface do usuário externa e não é registrada. |
|
Se essa não for uma instalação silenciosa, a interface do usuário básica foi inicializada. Se essa for uma instalação completa da interface do usuário, a interface do usuário completa ainda não será inicializada. Essa mensagem só é enviada para uma interface do usuário externa e não é registrada. |
|
Se uma interface do usuário completa estiver sendo usada, a interface do usuário completa será encerrada. Se essa não for uma instalação silenciosa, a interface do usuário básica ainda não foi encerrada. Essa mensagem só é enviada para uma interface do usuário externa e não é registrada. |
|
Enviado antes da exibição da caixa de diálogo completa da interface do usuário. Essa mensagem só é enviada para uma interface do usuário externa e não é registrada. |
|
A instalação do produto começa.
A mensagem contém ProductName e ProductCode do produto. |
|
A instalação do produto termina.
A mensagem contém ProductName, ProductCode e valor retornado do produto. |
[in] pvContext
Ponteiro para um contexto de aplicativo que é passado para a função de retorno de chamada. Esse parâmetro pode ser usado para verificação de erros.
Valor retornado
O valor retornado será o manipulador externo definido anteriormente ou zero (0) se não houver nenhum manipulador definido anteriormente.
Comentários
Para restaurar o manipulador de interface do usuário anterior, a segunda chamada é feita para MsiSetExternalUI usando o INSTALLUI_HANDLER retornado pela primeira chamada para MsiSetExternalUI e especificando zero (0) para dwMessageFilter.
O manipulador de interface do usuário externo apontado pelo parâmetro puiHandler não tem controle total sobre a interface do usuário externa, a menos que MsiSetInternalUI seja chamado com o parâmetro dwUILevel definido como INSTALLUILEVEL_NONE. Se MsiSetInternalUI não for chamado, o nível de interface do usuário interno usará como padrão INSTALLUILEVEL_BASIC. Como resultado, qualquer mensagem não manipulada pelo manipulador de interface do usuário externo é tratada pelo Windows Installer. A inicial "Preparando para instalar. . ." dialog always appears even if the external user interface handler handles all messages.
MsiSetExternalUI só deve ser chamado de um aplicativo de inicialização . Você não pode chamar MsiSetExternalUI de uma ação personalizada.
Observação
O cabeçalho msi.h define MsiSetExternalUI como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Cliente mínimo com suporte | Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP. Confira os Requisitos de tempo de execução do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer. |
| Plataforma de Destino | Windows |
| Cabeçalho | msi.h |
| Biblioteca | Msi.lib |
| DLL | Msi.dll |