Función SetupDiRemoveDeviceInterface (setupapi.h)
La función SetupDiRemoveDeviceInterface quita una interfaz de dispositivo registrada del sistema.
Sintaxis
WINSETUPAPI BOOL SetupDiRemoveDeviceInterface(
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData
);
Parámetros
[in] DeviceInfoSet
Puntero al conjunto de información del dispositivo que contiene la interfaz de dispositivo que se va a quitar. Este identificador normalmente lo devuelve SetupDiGetClassDevs.
[in, out] DeviceInterfaceData
Puntero a una estructura de SP_DEVICE_INTERFACE_DATA que especifica la interfaz del dispositivo en DeviceInfoSet que se va a quitar. Este puntero normalmente lo devuelve SetupDiEnumDeviceInterfaces.
Después de quitar la interfaz, esta función establece la marca SPINT_REMOVED en DeviceInterfaceData. Marcas. También borra la marca SPINT_ACTIVE, pero tenga en cuenta que esta marca ya debería haberse borrado antes de llamar a esta función.
Valor devuelto
SetupDiRemoveDeviceInterface devuelve TRUE si la función se completó sin error. Si la función se completó con un error, devuelve FALSE y el código de error del error se puede recuperar llamando a GetLastError.
Comentarios
El autor de la llamada de esta función debe ser miembro del grupo Administradores.
SetupDiRemoveDeviceInterface quita la interfaz de dispositivo especificada del sistema. Esto incluye eliminar la clave del Registro asociada.
Llame a SetupDiDeleteDeviceInterfaceData para eliminar la interfaz de una lista de información del dispositivo.
Se debe deshabilitar una interfaz de dispositivo para quitarse. Si la interfaz está habilitada, se produce un error en esta función y GetLastError devuelve ERROR_DEVICE_INTERFACE_ACTIVE. Deshabilite una interfaz mediante cualquier mecanismo específico de la interfaz que se proporcione (por ejemplo, un IOCTL). Si el autor de la llamada no tiene ninguna manera de deshabilitar una interfaz y la interfaz debe quitarse, el autor de la llamada debe detener el dispositivo subyacente mediante SetupDiChangeState. Detener el dispositivo deshabilita todas las interfaces expuestas por el dispositivo.
Requisitos
| Cliente mínimo compatible | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | setupapi.h (incluya Setupapi.h) |
| Library | Setupapi.lib |
| Archivo DLL | Setupapi.dll |