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

Consulte también

SetupDiChangeState

SetupDiCreateDeviceInterface

SetupDiDeleteDeviceInterfaceData

SetupDiEnumDeviceInterfaces

SetupDiGetClassDevs