Retornar valores de um manipulador de interface do usuário externa

Um manipulador de interface do usuário externa pode retornar qualquer número de valores para o Windows Installer, dependendo do tipo de botão fornecido no parâmetro de tipo de mensagem que o instalador passará para o manipulador.

O manipulador de interface do usuário externa poderá retornar os valores –1 e 0 a qualquer momento porque não estão relacionados aos tipos de botão. Um valor de retorno de –1 indica que ocorreu um erro interno no manipulador de interface do usuário externa. Um valor de retorno de 0 indica que o manipulador de interface do usuário externa não tratou a mensagem do instalador e o instalador deverá manipular a mensagem.

Para mensagens que não incluem um tipo de botão como INSTALLMESSAGE_ACTIONDATA e INSTALLMESSAGE_PROGRESS, ao retornar IDCANCEL cancelará a instalação. Retornar IDOK notificará o instalador de que a mensagem foi manipulada pelo manipulador de interface do usuário externa.

Os valores de retorno restantes, conforme descritos abaixo, estão diretamente relacionados aos tipos de botão incluídos no tipo de mensagem.

Valor de retorno da interface do usuário externa	Significado
IDOK	O botão OK foi pressionado pelo usuário. As informações da mensagem foram compreendidas.
IDCANCEL	O botão CANCELAR foi pressionado. Cancele a instalação.
IDABORT	O botão ANULAR foi pressionado. Anule a instalação.
IDRETRY	O botão REPETIR foi pressionado. Tente a ação novamente.
IDIGNORE	O botão IGNORAR foi pressionado. Ignore o erro e continue.
IDYES	O botão SIM foi pressionado. Resposta afirmativa, continue com a sequência atual de eventos.
IDNO	O botão NÃO foi pressionado. Resposta negativa, não continue com a sequência atual de eventos.

 

Por exemplo, se o manipulador de interface do usuário externa receber uma mensagem com o sinalizador de estilos de caixa de mensagem MB_ABORTRETRYIGNORE, o manipulador de interface do usuário externa poderá retornar um dos seguintes valores:

• –1 (erro no manipulador de interface do usuário externa)
• 0 (nenhuma ação executada no manipulador de interface do usuário externa, deixe o Windows Installer tratar isso)
• IDABORT (botão ANULAR pressionado)
• IDRETRY (botão REPETIR pressionado)
• IDIGNORE (botão IGNORAR pressionado)