DIF_FINISHINSTALL_ACTION
Una solicitud de DIF_FINISHINSTALL_ACTION permite que un instalador ejecute acciones de instalación de finalización en un contexto de administrador interactivo después de que se hayan completado todas las demás operaciones de instalación de dispositivos.
Cuándo se envió
En Windows 8 y versiones posteriores, las acciones de instalación de finalización no se ejecutan automáticamente como parte de la instalación del dispositivo. Para completar una acción de instalación de finalización del dispositivo, un usuario debe hacer clic en "Finalizar la instalación del software del dispositivo" en el Centro de actividades para completar la instalación.
Para obtener más información, consulte Ejecución de acciones de Finish-Install.
En Windows 7, el proceso de instalación de finalización solo se ejecuta en el contexto de un usuario con credenciales de administrador en una de las siguientes ocasiones:
- La próxima vez que un usuario que tenga credenciales de administrador inicie sesión mientras el dispositivo está conectado.
- Cuando se vuelve a adjuntar el dispositivo.
- Cuando el usuario selecciona Buscar cambios de hardware en Administrador de dispositivos.
Si un usuario ha iniciado sesión sin privilegios administrativos, Windows solicita al usuario el consentimiento y las credenciales para ejecutar las acciones de instalación de finalización en un contexto de administrador.
Quién controla
Coinserción de clase |
Puede controlar |
Coins installer del dispositivo |
Puede controlar |
Instalador de clase |
Puede controlar |
Entrada del instalador
DeviceInfoSet
Identificador del conjunto de información del dispositivo que contiene el dispositivo que se va a instalar.
DeviceInfoData
Puntero a una estructura de SP_DEVINFO_DATA que representa el dispositivo que se va a instalar.
Parámetros de instalación de dispositivos
Hay parámetros de instalación de dispositivos (una estructura SP_DEVINSTALL_PARAMS ) asociada a DeviceInfoData.
Parámetros de instalación de clases
Ninguno
Salida del instalador
Parámetros de instalación de dispositivos
Un instalador establece la marca DI_NEEDREBOOT si se requiere un reinicio del sistema para completar sus acciones de instalación de finalización.
Valor devuelto del instalador
Un instalador devuelve uno de los valores que se enumeran en la tabla siguiente.
| Valor devuelto | Significado |
|---|---|
ERROR_DI_DO_DEFAULT |
Instalador de clase: el instalador no tiene acciones de instalación de finalización, ha completado correctamente las acciones de instalación de fin o ha determinado que nunca puede completar correctamente sus acciones de instalación de finalización. La instalación del dispositivo debe realizar el procesamiento predeterminado de la solicitud. Co-installer: los co-installers no deben devolver este código de error. |
NO_ERROR |
Instalador de clase: un instalador de clase no debe devolver este código de error. Si un instalador de clase devuelve este código de error, la instalación del dispositivo no realiza el procesamiento predeterminado de la solicitud. Co-installer: el instalador no tiene ninguna acción de instalación de finalización, ha completado correctamente las acciones de instalación de fin o ha determinado que nunca puede completar correctamente sus acciones de instalación de finalización. |
Código de error Win32 |
Instalador de clase o coinstalación: el instalador encontró un error al procesar una acción de finalización de la instalación y la instalación del dispositivo debe intentar completar las acciones de instalación de finalización la próxima vez que se enumera el dispositivo en el contexto de un administrador. |
Controlador de código DIF predeterminado
Windows 7 usa SetupDiFinishInstallAction.
No hay ningún controlador de código DIF predeterminado en Windows 8 y versiones posteriores, y se ha quitado SetupDiFinishInstallAction.
Comentarios
Dado que la instalación del dispositivo no puede determinar a partir de un código de devolución de ERROR_DI_DO_DEFAULT o un código de retorno NO_ERROR si una acción de instalación de finalización se realizó correctamente, el instalador debe notificar al usuario el estado de una acción de instalador de fin.
Para obtener más información sobre las acciones de instalación de fin, vea How Device Installation Processes Finish-Install Actions and Implementing Finish-Install Actions.
Para obtener información general sobre los códigos DIF, vea Controlar códigos DIF y llamar a controladores de código DIF predeterminados.
Requisitos
Versión |
Compatible con Windows Vista a través de Windows 7. |
Encabezado |
Setupapi.h (incluya Setupapi.h) |