Compartilhar via


função de retorno de chamada INSTALLUI_HANDLER_RECORD (msi.h)

O protótipo da função INSTALLUI_HANDLER_RECORD define uma função de retorno de chamada que o instalador chama para mensagens de notificação de progresso e erro. Chame a função MsiSetExternalUIRecord para habilitar um manipulador de interface do usuário externa de base de registro.

Windows Installer 3.0 e Windows Installer 2.0: Sem suporte. Disponível a partir do Windows Installer versão 3.1 e posterior.

Sintaxe

INSTALLUI_HANDLER_RECORD InstalluiHandlerRecord;

int InstalluiHandlerRecord(
  LPVOID pvContext,
  UINT iMessageType,
  MSIHANDLE hRecord
)
{...}

Parâmetros

pvContext

Ponteiro para um contexto de aplicativo passado para a função MsiSetExternalUIRecord . 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.

Caixa de mensagem EstilosFlag Significado
MB_ABORTRETRYIGNORE
A caixa de mensagem contém os botões Anular, Repetir e Ignorar .
MB_OK
A caixa de mensagem contém o botão OK . Esse é o padrão.
MB_OKCANCEL
A caixa de mensagem contém os botões OK e Cancelar .
MB_RETRYCANCEL
A caixa de mensagem contém os botões Repetir e Cancelar .
MB_YESNO
A caixa de mensagem contém os botões Sim e Não .
MB_YESNOCANCEL
A caixa de mensagem contém os botões Sim, Não e Cancelar .
 
Ícone da caixa de mensagemTypesFlag Significado
MB_ICONEXCLAMATION, MB_ICONWARNING
Um ponto de exclamação aparece na caixa de mensagem.
MB_ICONINFORMATION, MB_ICONASTERISK
O sinal de informação aparece na caixa de mensagem.
MB_ICONQUESTION
Um ponto de interrogação aparece na caixa de mensagem.
MB_ICONSTOP, MB_ICONERROR, MB_ICONHAND
Um sinal de parada aparece na caixa de mensagem.
 
Botões PadrãoFlag Significado
MB_DEFBUTTON1
O primeiro botão é o botão padrão.
MB_DEFBUTTON2
O segundo botão é o botão padrão.
MB_DEFBUTTON3
O terceiro botão é o botão padrão.
 
Instalar tipos de mensagemFlag Significado
INSTALLMESSAGE_FATALEXIT
Término prematuro
INSTALLMESSAGE_ERROR
Mensagem de erro formatada
INSTALLMESSAGE_WARNING
Mensagem de aviso formatada
INSTALLMESSAGE_USER
Mensagem de solicitação do usuário.
INSTALLMESSAGE_INFO
Mensagem informativa para log
INSTALLMESSAGE_FILESINUSE
Lista de arquivos atualmente em uso que devem ser fechados antes de serem substituídos
INSTALLMESSAGE_RESOLVESOURCE
Solicitação para determinar um local de origem válido
INSTALLMESSAGE_RMFILESINUSE
Lista de arquivos atualmente em uso que devem ser fechados antes de serem substituídos. Disponível a partir do Windows Installer versão 4.0. Para obter mais informações sobre essa mensagem, consulte Usar o gerenciador de reinicialização com uma interface do usuário externa.
INSTALLMESSAGE_OUTOFDISKSPACE
Mensagem de espaço em disco insuficiente
INSTALLMESSAGE_ACTIONSTART
Mensagem de início da ação. Essa mensagem inclui o nome e a descrição da ação.
INSTALLMESSAGE_ACTIONDATA
Dados formatados associados ao item de ação individual.
INSTALLMESSAGE_PROGRESS
Informações do medidor de progresso. Esta mensagem inclui informações sobre unidades até o momento e o número total de unidades.
INSTALLMESSAGE_COMMONDATA
Informações de caixa de diálogo formatadas para interface do usuário.
INSTALLMESSAGE_INITIALIZE
Enviado antes da inicialização da interface do usuário, sem dados de cadeia de caracteres
INSTALLMESSAGE_TERMINATE
Enviado após o encerramento da interface do usuário, sem dados de cadeia de caracteres
INSTALLMESSAGE_SHOWDIALOG
Enviado antes da exibição da caixa de diálogo ou do assistente criado
INSTALLMESSAGE_INSTALLSTART
Enviado antes da instalação do produto.
INSTALLMESSAGE_INSTALLEND
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.

hRecord

Especifica um identificador para o objeto de registro. Para obter informações sobre objetos de registro, consulte Funções de processamento de registro.

Retornar valor

Os seguintes valores retornados são mapeados para os botões especificados pelo estilo da caixa de mensagem:

IDOK

 
IDCANCEL
 
IDABORT
 
IDRETRY
 
IDIGNORE
 
IDYES
 
IDNO

Comentários

Esse tipo de manipulador de interface do usuário externo deve ser usado quando se sabe em que tipo de erros ou mensagens o chamador está interessado e deseja evitar a sobrecarga de analisar a mensagem de cadeia de caracteres que é enviada para um manipulador de interface do usuário externo do tipo INSTALLUI_HANDLER, mas recuperar os dados de interesse dos campos de hRecord.

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 . O objeto hRecord enviado para o manipulador de interface do usuário externo baseado em registro pertence ao Windows Installer e é válido apenas para o tempo de vida do retorno de chamada. O retorno de chamada deve extrair do registro todos os dados necessários e não deve fechar esse identificador.

Qualquer tentativa de um manipulador de interface do usuário externo baseado em registro para alterar os dados no objeto hRecord será ignorada pelo Windows Installer.

Para obter mais informações sobre como usar um manipulador externo baseado em registro, confira Como monitorar uma instalação usando MsiSetExternalUIRecord.

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 3.1 no Windows Server 2003 ou Windows XP.
Plataforma de Destino Windows
Cabeçalho msi.h

Confira também

MsiSetExternalUI

Sem suporte no Windows Installer 3.0 e nas versões anteriores