Funzione SetupDiDeleteDeviceInfo (setupapi.h)
La funzione SetupDiDeleteDeviceInfo elimina un elemento informazioni dispositivo da un set di informazioni sul dispositivo. Questa funzione non elimina il dispositivo effettivo.
Sintassi
WINSETUPAPI BOOL SetupDiDeleteDeviceInfo(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData
);
Parametri
[in] DeviceInfoSet
Handle per il set di informazioni sul dispositivo contenente l'elemento informazioni del dispositivo da eliminare.
[in] DeviceInfoData
Puntatore a una struttura di SP_DEVINFO_DATA che rappresenta l'elemento informazioni del dispositivo in DeviceInfoSet da eliminare.
Valore restituito
La funzione restituisce TRUE se ha esito positivo. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato con una chiamata a GetLastError.
Commenti
Se l'elemento informazioni sul dispositivo specificato è in uso (ad esempio, da una pagina della procedura guidata), la funzione ha esito negativo. In questo caso, una chiamata a GetLastError restituisce ERROR_DEVINFO_DATA_LOCKED. Ciò accade se viene recuperato un handle in una pagina della procedura guidata con una chiamata a SetupDiGetWizardPage con questo elemento informativo del dispositivo specificato e il set di flag DIWP_FLAG_USE_DEVINFO_DATA. Per eliminare questo elemento di informazioni sul dispositivo, è prima necessario chiudere l'handle HPROPSHEETPAGE della procedura guidata.
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 |