Funzione SetupDiRemoveDevice (setupapi.h)

  • Articolo

La funzione SetupDiRemoveDevice è il gestore predefinito per la richiesta di installazione DIF_REMOVE .

Sintassi

WINSETUPAPI BOOL SetupDiRemoveDevice(
  [in]      HDEVINFO         DeviceInfoSet,
  [in, out] PSP_DEVINFO_DATA DeviceInfoData
);

Parametri

[in] DeviceInfoSet

Handle per un set di informazioni sul dispositivo per il sistema locale che contiene un elemento informazioni sul dispositivo che rappresenta il dispositivo da rimuovere.

[in, out] DeviceInfoData

Puntatore a una struttura SP_DEVINFO_DATA che specifica l'elemento informazioni sul dispositivo in DeviceInfoSet. Si tratta di un parametro IN-OUT perché DeviceInfoSet. DevInst potrebbe essere aggiornato con un nuovo valore handle al momento della restituzione. Se si tratta di una rimozione globale o dell'ultima rimozione specifica del profilo hardware, tutte le tracce dell'istanza del dispositivo vengono eliminate dal Registro di sistema e l'handle sarà NULL.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce TRUE . In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato da una chiamata a GetLastError.

Commenti

SetupDiRemoveDevice rimuove il dispositivo dal sistema. Elimina le chiavi del Registro di sistema hardware e software del dispositivo e tutte le chiavi del Registro di sistema specifiche del profilo hardware (chiavi del Registro di sistema specifiche della configurazione). Questa funzione arresta dinamicamente il dispositivo se DevInst è attivo e si tratta di una rimozione globale o dell'ultima rimozione specifica della configurazione. Se il dispositivo non può essere arrestato in modo dinamico, i flag vengono impostati nel blocco Installa parametro del set di informazioni sul dispositivo che alla fine fa sì che all'utente venga richiesto di riavviare il computer.

La rimozione del dispositivo è globale per tutti i profili hardware o specifica per un profilo hardware, come specificato dal membro Scope della struttura SP_REMOVEDEVICE_PARAMS che fornisce i parametri di installazione della classe per la richiesta di DIF_REMOVE. La rimozione specifica della configurazione è appropriata solo per i dispositivi enumerati radice e deve essere richiesta solo dal codice di sistema.

Il chiamante di SetupDiRemoveDevice deve essere membro del gruppo Administrators.

Nota Solo un programma di installazione di classe deve chiamare SetupDiRemoveDevice e solo in quelle situazioni in cui il programma di installazione della classe deve eseguire operazioni di rimozione del dispositivo dopo che SetupDiRemoveDevice completa l'operazione di rimozione predefinita del dispositivo. In tali situazioni, il programma di installazione della classe deve chiamare direttamente SetupDiRemoveDevice quando il programma di installazione elabora una richiesta di DIF_REMOVE. Per altre informazioni sulla chiamata al gestore predefinito, vedere Chiamata di gestori di codice DIF predefiniti.
 

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione Desktop
Intestazione setupapi.h (include Setupapi.h)
Libreria Setupapi.lib
DLL Setupapi.dll

Vedi anche

SP_DEVINFO_DATA

SP_REMOVEDEVICE_PARAMS