Acerca de la solicitud de disco y el control de errores
Aunque las funciones de instalación no proporcionan una interfaz de usuario, hay cuatro funciones de configuración que generan cuadros de diálogo para controlar situaciones comunes de instalación y recopilar información del usuario. Estos son: SetupPromptForDisk, SetupCopyError, SetupRenameError y SetupDeleteError.
Las rutinas de devolución de llamada pueden llamar a estas funciones para crear cuadros de diálogo para ayudar a procesar las notificaciones enviadas por otras funciones de instalación, como SetupCommitFileQueue y SetupInstallFile.
La función SetupPromptForDisk solicita al usuario que inserte medios extraíbles, especifique una nueva ruta de acceso de origen o cancele la instalación. La aplicación puede ofrecer opciones adicionales al usuario, según las marcas especificadas cuando se llame a la función. Entre ellas se incluyen omitir el archivo actual o examinar una nueva ruta de acceso de origen.
Las tres funciones, SetupCopyError, SetupRenameError y SetupDeleteError, crean cuadros de diálogo que interactúan con el usuario para recopilar información del usuario sobre cómo continuar cuando se ha producido un error.
La función SetupCopyError genera un cuadro de diálogo que pregunta al usuario cómo recuperarse de un error de copia. El usuario puede especificar una nueva ruta de acceso de origen para la operación de copia o cancelar la instalación. Dependiendo de las marcas especificadas durante la llamada a SetupCopyError, el usuario también puede buscar una nueva ruta de acceso de origen, ver los detalles del error o omitir el archivo actual.
Se puede generar un cuadro de diálogo que pregunte al usuario cómo procesar los errores que se producen durante una operación de cambio de nombre de archivo mediante una llamada a SetupRenameError. Con este cuadro de diálogo, el usuario tiene la oportunidad de reintentar la operación, omitir la operación de cambio de nombre actual o anularla.
La función SetupDeleteError genera un cuadro de diálogo que puede recopilar entradas sobre cómo el usuario desea controlar un error que se produjo durante una operación de eliminación de archivos. Al usuario se le proporcionan las opciones para reintentar la operación, omitir la operación de eliminación actual o anularla.
La rutina de devolución de llamada de cola predeterminada , SetupDefaultQueueCallback, usa las cuatro funciones mencionadas anteriormente para generar partes de su interfaz de usuario y controlar los errores y solicitar nuevos medios.