Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Um manipulador de interface do usuário (UI) externo 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 passa para o manipulador.
O manipulador de interface do usuário externo pode retornar os valores –1 e 0 a qualquer momento porque eles 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 externo. Um valor de retorno de 0 indica que o manipulador de interface do usuário externo não manipulou a mensagem do instalador e o instalador deve manipular a mensagem em vez disso.
Para mensagens que não incluem um tipo de botão, como INSTALLMESSAGE_ACTIONDATA e INSTALLMESSAGE_PROGRESS, retornar IDCANCEL cancela a instalação. O retorno do IDOK notifica o instalador de que a mensagem foi manipulada pelo manipulador de interface do usuário externo.
Os valores de retorno restantes, conforme descrito abaixo, estão diretamente relacionados aos tipos de botão incluídos no tipo de mensagem.
| Valor de retorno da interface externa | Significado |
|---|---|
| IDOK | O botão OK foi pressionado pelo usuário. A informação da mensagem foi entendida. |
| IDCANCEL | O botão CANCELAR foi pressionado. Cancele a instalação. |
| IDABORT | O botão ABORT foi pressionado. Anule a instalação. |
| IDRETRY | O botão RETRY foi pressionado. Tente a ação novamente. |
| IDIGNORE | O botão IGNORE foi pressionado. Ignore o erro e continue. |
| IDSIM | O botão SIM foi pressionado. A resposta afirmativa, continuar com a sequência atual de eventos. |
| IDNO | O botão NO foi pressionado. A resposta negativa; não continue com a atual sequência de eventos. |
Por exemplo, se o manipulador de interface do usuário externo receber uma mensagem com o sinalizador de estilos de caixa de mensagem MB_ABORTRETRYIGNORE, o manipulador de interface do usuário externo poderá retornar um dos seguintes valores:
- –1 (erro no manipulador de interface do usuário externo)
- 0 (nenhuma ação executada no manipulador de interface do usuário externo, deixe o Windows Installer lidar com isso)
- IDABORT (botão ABORT pressionado)
- IDRETRY (TENTAR NOVAMENTE botão pressionado)
- IDIGNORE (botão IGNORE pressionado)