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

  • Artigo

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