INSTALLUI_HANDLERA função de retorno de chamada (msi.h)
O protótipo da função INSTALLUI_HANDLER define uma função de retorno de chamada que o instalador chama para mensagens de notificação de progresso e erro. Para obter mais informações sobre o uso desse protótipo de função, um snippet de código de exemplo está disponível no tratamento de mensagens de progresso usando MsiSetExternalUI.
Sintaxe
INSTALLUI_HANDLERA InstalluiHandlera;
int InstalluiHandlera(
LPVOID pvContext,
UINT iMessageType,
LPCSTR szMessage
)
{...}
Parâmetros
pvContext
Ponteiro para um contexto de aplicativo passado para a função MsiSetExternalUI . Esse parâmetro pode ser usado para verificação de erros.
iMessageType
Especifica uma combinação de um estilo de caixa de mensagem, um tipo de ícone de caixa de mensagem, um botão padrão e um tipo de mensagem de instalação. Esse parâmetro deve ser um dos seguintes.
| Botões PadrãoFlag | Significado |
|---|---|
|
O primeiro botão é o botão padrão. |
|
O segundo botão é o botão padrão. |
|
O terceiro botão é o botão padrão. |
| Instalar tipos de mensagemFlag | Significado |
|---|---|
|
Término prematuro |
|
Mensagem de erro formatada |
|
Mensagem de aviso formatada |
|
Mensagem de solicitação do usuário. |
|
Mensagem informativa para log |
|
Lista de arquivos atualmente em uso que devem ser fechados antes de serem substituídos. |
|
Solicitação para determinar um local de origem válido |
|
Lista de arquivos atualmente em uso que devem ser fechados antes de serem substituídos. Disponível a partir do Windows Installer 4.0. Para obter mais informações sobre essa mensagem, consulte Usar o gerenciador de reinicialização com uma interface do usuário externa. |
|
Mensagem de espaço em disco insuficiente |
|
Mensagem de início da ação. Essa mensagem inclui o nome e a descrição da ação. |
|
Dados formatados associados ao item de ação individual. |
|
Informações do medidor de progresso. Esta mensagem inclui informações sobre unidades até o momento e o número total de unidades. |
|
Informações de caixa de diálogo formatadas para interface do usuário. |
|
Enviado antes da inicialização da interface do usuário, sem dados de cadeia de caracteres |
|
Enviado após o encerramento da interface do usuário, sem dados de cadeia de caracteres |
|
Enviado antes da exibição da caixa de diálogo ou do assistente criado |
|
Enviado antes da instalação do produto. |
|
Enviado após a instalação do produto. |
Os seguintes padrões deverão ser usados se alguma das mensagens anteriores estiver ausente: MB_OK, sem ícone e MB_DEFBUTTON1. Não há nenhum tipo de mensagem de instalação padrão; um tipo de mensagem sempre é especificado.
szMessage
Especifica o texto da mensagem.
Retornar valor
Os seguintes valores retornados são mapeados para os botões especificados pelo estilo da caixa de mensagem:
IDOK
Comentários
Para obter mais informações sobre como retornar valores de um manipulador de interface do usuário externo, consulte o tópico Retornando valores de um manipulador de interface do usuário externo .
Observação
O cabeçalho msi.h define INSTALLUI_HANDLER 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
| Requisito | Valor |
|---|---|
| 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 |
| Plataforma de Destino | Windows |
| Cabeçalho | msi.h |