Implementazione di azioni di Finish-Install
Nota
Le funzionalità descritte in questa sezione non sono supportate nei pacchetti di driver universali o mobili. Vedere Uso di un file INF universale.
I programmi di installazione (un programma di installazione di classe, il co-installer di classe o il co-installer del dispositivo) forniscono azioni di installazione completa. Un'azione di installazione completa può eseguire un programma eseguibile, creare un processo, creare un thread o eseguire codice nel processo di installazione del driver del dispositivo.
Per implementare azioni di installazione completa, un programma di installazione:
Imposta il flag di DI_FLAGSEX_FINISHINSTALL_ACTION quando il programma di installazione elabora un codice DIF DIF_NEWDEVICEWIZARD_FINISHINSTALL e restituisce uno dei codici di errore seguenti:
- ERROR_DI_DO_DEFAULT se è un programma di installazione di classe senza pagine della procedura guidata di installazione completa.
- NO_ERROR se si tratta di un programma di installazione di classe con pagine della procedura guidata di installazione completa o di un co-installer con o senza pagine della procedura guidata di installazione completa.
Esegue le azioni di installazione completa quando elabora una richiesta di DIF_FINISHINSTALL_ACTION .
Un programma di installazione restituisce uno dei codici di errore nella tabella seguente.
Codice di errore Significato ERROR_DI_DO_DEFAULT
Programma di installazione della classe: il programma di installazione della classe ha eseguito correttamente le azioni di installazione completa e richiede a Windows di eseguire l'elaborazione predefinita. Un programma di installazione della classe deve restituire anche questo codice di errore se non dispone di azioni di installazione completa.
Co-installer del dispositivo o della classe: i co-installer non restituiscono questo codice di errore.
NO_ERROR
Programma di installazione della classe: il programma di installazione della classe ha eseguito correttamente l'azione di installazione completa. Windows non deve eseguire l'elaborazione predefinita.
Co-installer del dispositivo o della classe: il co-installer ha eseguito correttamente le azioni di completamento dell'installazione o non ha azioni di installazione completa.
Errore Microsoft Win32
Il programma di installazione ha rilevato un errore, ma l'azione di installazione completata deve essere riprovata. La restituzione di un codice di errore Win32 indica che Windows deve eseguire un altro processo di installazione finale per completare le azioni di installazione completa alla successiva enumerazione del dispositivo.
Nota Se un'azione di installazione completata ha esito negativo e non deve essere riprovata, un programma di installazione della classe restituisce ERROR_DI_DO_DEFAULT e un co-programma di installazione di un dispositivo o di classe restituisce NO_ERROR.
Per informazioni su come sviluppare azioni di installazione completa, vedere Linee guida per l'implementazione di azioni di Finish-Install Per codice di esempio che illustra come implementare azioni di installazione completa, vedere gli argomenti seguenti:
Esempio di codice: Finish-Install azioni in un programma di installazione di classi