DIF_FINISHINSTALL_ACTION
Una richiesta di DIF_FINISHINSTALL_ACTION consente a un programma di installazione di eseguire azioni di completamento dell'installazione in un contesto di amministratore interattivo dopo il completamento di tutte le altre operazioni di installazione del dispositivo.
Data di invio
In Windows 8 e versioni successive le azioni di fine installazione non vengono eseguite automaticamente come parte dell'installazione del dispositivo. Per completare un'azione di completamento dell'installazione del dispositivo, un utente deve fare clic su "Fine installazione del software del dispositivo" nel Centro notifiche per completare l'installazione.
Per altre informazioni, vedere Esecuzione di azioni Finish-Install.
In Windows 7, il processo di installazione completato viene eseguito solo nel contesto di un utente con credenziali di amministratore in uno dei casi seguenti:
- Al successivo accesso di un utente con credenziali di amministratore durante il collegamento del dispositivo.
- Quando il dispositivo viene ricollegato.
- Quando l'utente seleziona Cerca modifiche hardware in Gestione dispositivi.
Se un utente ha eseguito l'accesso senza privilegi amministrativi, Windows richiede all'utente il consenso e le credenziali per eseguire le azioni di installazione completa in un contesto di amministratore.
Chi gestisce
Co-programma di installazione classi |
Può gestire |
Programma di installazione condivisa del dispositivo |
Può gestire |
Programma di installazione classi |
Può gestire |
Input del programma di installazione
DeviceInfoSet
Handle per il set di informazioni sul dispositivo che contiene il dispositivo in fase di installazione.
DeviceInfoData
Puntatore a una struttura SP_DEVINFO_DATA che rappresenta il dispositivo in fase di installazione.
Parametri di installazione del dispositivo
Esistono parametri di installazione del dispositivo (una struttura di SP_DEVINSTALL_PARAMS ) associati a DeviceInfoData.
Parametri di installazione della classe
Nessuno
Output del programma di installazione
Parametri di installazione del dispositivo
Un programma di installazione imposta il flag DI_NEEDREBOOT se è necessario un riavvio del sistema per completare le azioni di installazione completa.
Valore restituito del programma di installazione
Un programma di installazione restituisce uno dei valori elencati nella tabella seguente.
| Valore restituito | Significato |
|---|---|
ERROR_DI_DO_DEFAULT |
Programma di installazione classi: il programma di installazione non ha azioni di installazione completate, ha completato correttamente le azioni di installazione completate o ha stabilito che non può mai completare correttamente le azioni di installazione completa. L'installazione del dispositivo deve eseguire l'elaborazione predefinita per la richiesta. Co-installer: i co-installer non devono restituire questo codice di errore. |
NO_ERROR |
Programma di installazione classi: un programma di installazione di classe non deve restituire questo codice di errore. Se un programma di installazione classi restituisce questo codice di errore, l'installazione del dispositivo non esegue l'elaborazione predefinita per la richiesta. Programma di installazione condivisa: il programma di installazione non ha azioni di installazione completate, ha completato correttamente le azioni di installazione completate o ha stabilito che non è mai stato possibile completare correttamente le azioni di installazione completate. |
Codice di errore Win32 |
Programma di installazione classi o programma di installazione condivisa: il programma di installazione ha rilevato un errore durante l'elaborazione di un'azione di completamento dell'installazione e l'installazione del dispositivo deve tentare di completare le azioni di fine installazione alla successiva enumerazione del dispositivo nel contesto di un amministratore. |
Gestore di codice DIF predefinito
Windows 7 usa SetupDiFinishInstallAction.
Non esiste un gestore di codice DIF predefinito in Windows 8 e versioni successive e SetupDiFinishInstallAction è stato rimosso.
Commenti
Poiché l'installazione del dispositivo non è in grado di determinare da un codice restituito ERROR_DI_DO_DEFAULT o da un codice restituito NO_ERROR se un'azione di installazione completata ha effettivamente avuto esito positivo, il programma di installazione deve notificare all'utente lo stato di un'azione di completamento del programma di installazione.
Per altre informazioni sulle azioni di installazione completa, vedere How Device Installation Processes Finish-Install Actions and Implementing Finish-Install Actions.For more information about finish-install actions, see How Device Installation Processes Finish-Install Actions and Implementing Finish-Install Actions.
Per informazioni generali sui codici DIF, vedere Gestione dei codici DIF e Chiamatadi gestori di codice DIF predefiniti.
Requisiti
Versione |
Supportato in Windows Vista tramite Windows 7. |
Intestazione |
Setupapi.h (include Setupapi.h) |