Implementación de acciones de Finish-Install

Nota

Las características descritas en esta sección no se admiten en paquetes de controladores universales o móviles. Consulte Uso de un archivo INF universal.

Los instaladores (un instalador de clase, el co-instalador de clase o el co-instalador del dispositivo) proporcionan acciones de instalación de finalización. Una acción de instalación de finalización puede ejecutar un programa ejecutable, crear un proceso, crear un subproceso o ejecutar código en el proceso de finalización de instalación del controlador de dispositivo.

Para implementar acciones de instalación completa, un instalador:

1. Establece la marca DI_FLAGSEX_FINISHINSTALL_ACTION cuando el instalador procesa un código DIF DIF_NEWDEVICEWIZARD_FINISHINSTALL y devuelve uno de los siguientes códigos de error:

   • ERROR_DI_DO_DEFAULT si es un instalador de clase sin páginas del Asistente para instalación de finalización.
   • NO_ERROR si es un instalador de clase con páginas del asistente para finalizar la instalación o un co-instalador con o sin páginas del asistente para finalizar la instalación.

2. Realiza las acciones de instalación de finalización cuando procesa una solicitud de DIF_FINISHINSTALL_ACTION .

   Un instalador devuelve uno de los códigos de error de la tabla siguiente.

   Código de error	Significado
   ERROR_DI_DO_DEFAULT	Instalador de clase: el instalador de clase ha ejecutado correctamente sus acciones de instalación de finalización y solicita a Windows que realice su procesamiento predeterminado. Un instalador de clase también debe devolver este código de error si no tiene acciones de instalación de finalización. Dispositivo o co-instalador de clase: los co-instaladores no devuelven este código de error.
   NO_ERROR	Instalador de clase: el instalador de clase ha ejecutado correctamente su acción de finalización de instalación. Windows no debe realizar su procesamiento predeterminado. Dispositivo o co-instalador de clase: el co-instalador ha ejecutado correctamente sus acciones de instalación de finalización o no tiene acciones de instalación de finalización.
   Error de Microsoft Win32	El instalador encontró un error, pero la acción finalizar la instalación debe intentarse de nuevo. Si se devuelve un código de error win32, se indica que Windows debe ejecutar otro proceso de instalación de finalización para completar las acciones de instalación de finalización la próxima vez que se enumera el dispositivo.

Nota Si se produce un error en una acción de finalización de la instalación y no se debe volver a intentarlo, un instalador de clase devuelve ERROR_DI_DO_DEFAULT y un dispositivo o un co-instalador de clase devuelve NO_ERROR.

Para obtener información sobre cómo desarrollar acciones de instalación de finalización, vea Guidelines for Implementing Finish-Install Actions For sample code that shows how to implement finish-install actions, see the following topics:

Ejemplo de código: acciones de Finish-Install en un instalador de clase

Ejemplo de código: acciones de Finish-Install en un co-instalador