Funzione DiUninstallDriverW (newdev.h)

La funzione di DiUninstallDriver rimuove un pacchetto driver da tutti i dispositivi in cui viene installato installando tali dispositivi con un altro pacchetto driver corrispondente, se disponibile o il driver Null se non è disponibile alcun altro pacchetto driver corrispondente. Il pacchetto driver specificato viene quindi rimosso dall'archivio driver .

Sintassi

BOOL DiUninstallDriverW(
  [in, optional]  HWND    hwndParent,
  [in]            LPCWSTR InfPath,
  [in]            DWORD   Flags,
  [out, optional] PBOOL   NeedReboot
);

Parametri

[in, optional] hwndParent

Handle per la finestra di primo livello che DiUninstallDriver deve usare per visualizzare qualsiasi componente dell'interfaccia utente associato alla disinstallazione del driver. Questo parametro è facoltativo e può essere impostato su NULL.

[in] InfPath

Puntatore a una stringa con terminazione NULL che fornisce il percorso completo del file INF per il pacchetto driver .

[in] Flags

Valore di tipo DWORD che specifica zero o uno o più dei flag seguenti: DIURFLAG_NO_REMOVE_INF. In genere, questo flag deve essere impostato su zero.

Se questo flag è zero, DiUninstallDriver rimuove il pacchetto driver da tutti i dispositivi in cui è installato installando tali dispositivi con un altro pacchetto driver corrispondente, se disponibile o il driver Null se non è disponibile alcun altro pacchetto driver corrispondente. Tuttavia, se questo flag è impostato su DIURFLAG_NO_REMOVE_INF, DiUninstallDriver rimuove il pacchetto driver da tutti i dispositivi in cui è installato, ma non rimuove il pacchetto driver dall'archivio driver.

[out, optional] NeedReboot

Puntatore a un valore di tipo BOOL che DiUninstallDriver imposta per indicare se è necessario un riavvio del sistema per completare la disinstallazione. Questo parametro è facoltativo e può essere NULL. Se viene specificato il parametro e per completare la disinstallazione è necessario riavviare il sistema, DiUninstallDriver imposta il valore su TRUE. In questo caso, il chiamante deve chiedere all'utente di riavviare il sistema. Se questo parametro viene fornito e non è necessario riavviare il sistema per completare la disinstallazione, DiUninstallDriver imposta il valore su FALSE. Se il parametro è NULL ed è necessario un riavvio del sistema per completare la disinstallazione, DiUninstallDriver visualizza una finestra di dialogo di riavvio del sistema. Per altre informazioni su questo parametro, vedere la sezione osservazioni seguente.

Valore restituito

DiUninstallDriver restituisce TRUE se la funzione rimuove correttamente il pacchetto driver da tutti i dispositivi in cui è installato e viene rimosso correttamente dall'archivio driver del sistema. Se il pacchetto driver non viene disinstallato correttamente dall'archivio driver, DiUninstallDriver restituisce FALSE e l'errore registrato può essere recuperato effettuando una chiamata a GetLastError. Di seguito sono riportati alcuni dei valori di errore più comuni che GetLastError:

Osservazioni

In generale, un'applicazione di disinstallazione deve impostare NeedReboot su null per indirizzare DiUninstallDriver per chiedere all'utente di riavviare il sistema se è necessario completare la rimozione. Un'applicazione deve fornire un puntatore NeedReboot solo nei casi seguenti:

• L'applicazione deve chiamare DiUninstallDriver più volte per completare una disinstallazione. In questo caso, l'applicazione deve registrare se un valore TRUENeedReboot viene restituito da una delle chiamate a DiUninstallDriver e, in tal caso, chiedere all'utente di riavviare il sistema dopo la chiamata finale a DiUninstallDriver.
• L'applicazione deve eseguire operazioni necessarie, oltre a chiamare DiUninstallDriver, prima che si verifichi un riavvio del sistema. Se è necessario un riavvio del sistema, l'applicazione deve completare le operazioni necessarie e quindi chiedere all'utente di riavviare il sistema.

Fabbisogno

Vedere anche

DiUninstallDevice