Funzione SetupDiUnremoveDevice (setupapi.h)

  • Articolo

La funzione SetupDiUnremoveDevice è il gestore predefinito per la richiesta di installazione DIF_UNREMOVE .

Sintassi

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

Parametri

[in] DeviceInfoSet

Handle a un set di informazioni sul dispositivo per il sistema locale che contiene un elemento informazioni sul dispositivo che rappresenta un dispositivo da ripristinare e riavviare.

[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é DeviceInfoData.DevInst potrebbe essere aggiornato con un nuovo valore di handle in caso di restituzione.

Valore restituito

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

Commenti

SetupDiUnremoveDevice ripristina un dispositivo in un profilo hardware. Questa funzione avvia il dispositivo, se possibile, o imposta un flag nei parametri di installazione del dispositivo che provoca l'arresto del sistema da parte dell'utente.

Nota Solo un programma di installazione della classe deve chiamare SetupDiUnremoveDevice e solo in tali situazioni in cui il programma di installazione della classe deve eseguire operazioni di annullamento del dispositivo dopo il completamento dell'operazione di annullamento del dispositivo predefinito. In tali situazioni, il programma di installazione della classe deve chiamare direttamente SetupDiUnremoveDevice quando il programma di installazione elabora una richiesta di DIF_UNREMOVE. Per altre informazioni sulla chiamata al gestore predefinito, vedere Chiamata di gestori di codice DIF predefiniti.
 
Il dispositivo ripristinato deve avere parametri di installazione della classe per DIF_UNREMOVE o la funzione ha esito negativo e GetLastError restituisce ERROR_NO_CLASSINSTALL_PARAMS.

DeviceInfoSet deve contenere solo elementi nel computer locale.

Il chiamante di SetupDiUnremoveDevice deve essere membro del gruppo Administrators.

Requisiti

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

Vedi anche

DIF_UNREMOVE

SP_DEVINFO_DATA

SetupDiRemoveDevice