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

Vedi anche

SetupDiChangeState

SetupDiCreateDeviceInterface

SetupDiDeleteDeviceInterfaceData

SetupDiEnumDeviceInterfaces

SetupDiGetClassDevs