Funzione SetupDiRemoveDeviceInterface (setupapi.h)
La funzione SetupDiRemoveDeviceInterface rimuove un'interfaccia del dispositivo registrata dal sistema.
Sintassi
WINSETUPAPI BOOL SetupDiRemoveDeviceInterface(
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData
);
Parametri
[in] DeviceInfoSet
Puntatore al set di informazioni sul dispositivo che contiene l'interfaccia del dispositivo da rimuovere. Questo handle viene in genere restituito da SetupDiGetClassDevs.
[in, out] DeviceInterfaceData
Puntatore a una struttura SP_DEVICE_INTERFACE_DATA che specifica l'interfaccia del dispositivo in DeviceInfoSet da rimuovere. Questo puntatore viene in genere restituito da SetupDiEnumDeviceInterfaces.
Dopo la rimozione dell'interfaccia, questa funzione imposta il flag SPINT_REMOVED in DeviceInterfaceData. Flag. Cancella anche il flag SPINT_ACTIVE, ma tenere presente che questo flag deve essere già stato cancellato prima della chiamata a questa funzione.
Valore restituito
SetupDiRemoveDeviceInterface restituisce TRUE se la funzione è stata completata senza errori. Se la funzione è stata completata con un errore, restituisce FALSE e il codice di errore per l'errore può essere recuperato chiamando GetLastError.
Commenti
Il chiamante di questa funzione deve essere membro del gruppo Administrators.
SetupDiRemoveDeviceInterface rimuove l'interfaccia del dispositivo specificata dal sistema. Ciò include l'eliminazione della chiave del Registro di sistema associata.
Chiamare SetupDiDeleteDeviceInterfaceData per eliminare l'interfaccia da un elenco di informazioni sul dispositivo.
È necessario disabilitare un'interfaccia del dispositivo da rimuovere. Se l'interfaccia è abilitata, questa funzione ha esito negativo e GetLastError restituisce ERROR_DEVICE_INTERFACE_ACTIVE. Disabilitare un'interfaccia usando qualsiasi meccanismo specifico dell'interfaccia, ad esempio un IOCTL. Se il chiamante non ha modo di disabilitare un'interfaccia e l'interfaccia deve essere rimossa, il chiamante deve arrestare il dispositivo sottostante usando SetupDiChangeState. L'arresto del dispositivo disabilita tutte le interfacce esposte dal dispositivo.
Requisiti
| 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 |