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 de 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 manipulação 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
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.
| ButtonsFlag padrão | 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 o TypesFlag de mensagens | 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 Usando o Restart Manager com uma interface do usuário externa. |
|
Mensagem de espaço em disco insuficiente |
|
Início da mensagem de ação. Essa mensagem inclui o nome da ação e a descrição. |
|
Dados formatados associados ao item de ação individual. |
|
Informações do medidor de progresso. Essa mensagem inclui informações sobre unidades até o momento e o número total de unidades. |
|
Informações da caixa de diálogo formatada para a 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 de criação |
|
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, nenhum í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.
Valor de retorno
Os seguintes valores retornados são mapeados para os botões especificados pelo estilo da caixa de mensagem:
IDOK
Observações
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 tópico.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Installer 5.0 no Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou Windows Vista. Windows Installer no Windows Server 2003 ou Windows XP |
| da Plataforma de Destino |
Windows |
| cabeçalho | msi.h |