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.
| 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 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. |
|
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.
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
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
Sem suporte no Windows Installer 3.0 e nas versões anteriores