DIF_FINISHINSTALL_ACTION
Une demande de DIF_FINISHINSTALL_ACTION permet à un programme d’installation d’exécuter des actions de fin-installation dans un contexte d’administrateur interactif une fois toutes les autres opérations d’installation d’appareil terminées.
Date d’envoi
Dans Windows 8 et versions ultérieures, les actions de fin d’installation ne s’exécutent pas automatiquement dans le cadre de l’installation de l’appareil. Pour effectuer une action de fin-installation de l’appareil, un utilisateur doit cliquer sur « Terminer l’installation du logiciel de l’appareil » dans le Centre de notifications pour terminer l’installation.
Pour plus d’informations, consultez Exécution d’actions Finish-Install.
Dans Windows 7, le processus de fin-installation s’exécute uniquement dans le contexte d’un utilisateur disposant d’informations d’identification d’administrateur à l’un des moments suivants :
- La prochaine fois qu’un utilisateur disposant des informations d’identification d’administrateur se connecte alors que l’appareil est attaché.
- Lorsque l’appareil est attaché de nouveau.
- Lorsque l’utilisateur sélectionne Rechercher les modifications matérielles dans Gestionnaire de périphériques.
Si un utilisateur est connecté sans privilèges d’administrateur, Windows invite l’utilisateur à fournir son consentement et ses informations d’identification pour exécuter les actions de fin d’installation dans un contexte administrateur.
Qui gère
Co-programme d’installation de classe |
Peut gérer |
Co-programme d’installation d’appareil |
Peut gérer |
Programme d’installation de classe |
Peut gérer |
Entrée du programme d’installation
DeviceInfoSet
Handle du jeu d’informations sur l’appareil qui contient l’appareil en cours d’installation.
DeviceInfoData
Pointeur vers une structure de SP_DEVINFO_DATA qui représente l’appareil en cours d’installation.
Paramètres d’installation de l’appareil
Des paramètres d’installation d’appareil (structure SP_DEVINSTALL_PARAMS ) sont associés à DeviceInfoData.
Paramètres d’installation de classe
None
Sortie du programme d’installation
Paramètres d’installation de l’appareil
Un programme d’installation définit l’indicateur DI_NEEDREBOOT si un redémarrage du système est nécessaire pour effectuer ses actions de fin d’installation.
Valeur de retour du programme d’installation
Un programme d’installation retourne l’une des valeurs répertoriées dans le tableau suivant.
| Valeur retournée | Signification |
|---|---|
ERROR_DI_DO_DEFAULT |
Programme d’installation de classe : le programme d’installation n’a pas d’actions d’installation de fin, a effectué les actions de fin-installation ou a déterminé qu’il ne pouvait jamais terminer ses actions d’installation de fin. L’installation de l’appareil doit effectuer le traitement par défaut de la demande. Co-programme d’installation : les co-programmes d’installation ne doivent pas retourner ce code d’erreur. |
NO_ERROR |
Programme d’installation de classe : un programme d’installation de classe ne doit pas retourner ce code d’erreur. Si un programme d’installation de classe retourne ce code d’erreur, l’installation de l’appareil n’effectue pas le traitement par défaut de la requête. Co-programme d’installation : le programme d’installation n’a pas d’actions de fin d’installation, a terminé avec succès les actions de fin d’installation ou a déterminé qu’il ne pouvait jamais réussir ses actions d’installation de fin. |
Code d’erreur Win32 |
Programme d’installation ou co-programme d’installation de classe : le programme d’installation a rencontré une erreur lors du traitement d’une action terminer-installer, et l’installation de l’appareil doit tenter d’effectuer les actions de fin-installation la prochaine fois que l’appareil est énuméré dans le contexte d’un administrateur. |
Gestionnaire de code DIF par défaut
Windows 7 utilise SetupDiFinishInstallAction.
Il n’existe aucun gestionnaire de code DIF par défaut dans Windows 8 et versions ultérieures, et SetupDiFinishInstallAction a été supprimé.
Commentaires
Étant donné que l’installation de l’appareil ne peut pas déterminer à partir d’un code de retour ERROR_DI_DO_DEFAULT ou d’un code de retour de NO_ERROR si une action de fin-installation a réussi, le programme d’installation doit informer l’utilisateur de l’status d’une action terminer le programme d’installation.
Pour plus d’informations sur les actions de fin-installation, consultez How Device Installation Process Finish-Install Actions et Implementing Finish-Install Actions.
Pour obtenir des informations générales sur les codes DIF, consultez Gestion des codes DIF et appel des gestionnaires de code DIF par défaut.
Spécifications
Version |
Pris en charge dans Windows Vista à Windows 7. |
En-tête |
Setupapi.h (inclure Setupapi.h) |