Lire en anglais

Partager via


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)

Voir aussi

SetupDiFinishInstallAction