Devolución de valores de un controlador de interfaz de usuario externo
Un controlador de interfaz de usuario (UI) externo puede devolver cualquier número de valores a Windows Installer en función del tipo de botón proporcionado en el parámetro de tipo de mensaje que el instalador pasa al controlador.
El controlador de interfaz de usuario externo puede devolver los valores –1 y 0 en cualquier momento porque no están relacionados con los tipos de botón. Un valor devuelto de –1 indica que se produjo un error interno en el controlador de interfaz de usuario externo. Un valor devuelto de 0 indica que el controlador de interfaz de usuario externo no ha controlado el mensaje del instalador y el instalador debe hacerlo en su lugar.
Para mensajes que no incluyen un tipo de botón, como INSTALLMESSAGE_ACTIONDATA y INSTALLMESSAGE_PROGRESS, la devolución de IDCANCEL cancela la instalación. Devolver IDOK notifica al instalador que el controlador de interfaz de usuario externo controló el mensaje.
Los valores devueltos restantes, tal como se describe a continuación, están directamente relacionados con los tipos de botón que se incluyen con el tipo de mensaje.
| Valor devuelto de la interfaz de usuario externa | Significado |
|---|---|
| IDOK | El usuario presionó el botón OK. Se entendió la información del mensaje. |
| IDCANCEL | Se presionó el botón CANCEL. Cancele la instalación. |
| IDABORT | Se presionó el botón ABORT. Anule la instalación. |
| IDRETRY | Se presionó el botón RETRY. Vuelva a intentar la acción. |
| IDIGNORE | Se presionó el botón IGNORE. Ignore el error y continúe. |
| IDYES | Se presionó el botón YES. La respuesta afirmativa significa que la secuencia actual de eventos continúa. |
| IDNO | Se presionó el botón NO. La respuesta negativa significa que la secuencia actual de eventos no continúa. |
Por ejemplo, si se envía al controlador de interfaz de usuario externo un mensaje con la marca de estilos de cuadro de mensaje MB_ABORTRETRYIGNORE, el controlador de interfaz de usuario externo puede devolver uno de estos valores:
- –1 (error en el controlador de interfaz de usuario externo)
- 0 (no se realiza ninguna acción en el controlador de interfaz de usuario externo; deje que Windows Installer lo controle)
- IDABORT (se presionó el botón ABORT)
- IDRETRY (se presionó el botón RETRY)
- IDIGNORE (se presionó el botón IGNORE)