Função SetupDiRemoveDeviceInterface (setupapi.h)
A função SetupDiRemoveDeviceInterface remove uma interface de dispositivo registrada do sistema.
Sintaxe
WINSETUPAPI BOOL SetupDiRemoveDeviceInterface(
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData
);
Parâmetros
[in] DeviceInfoSet
Um ponteiro para o conjunto de informações do dispositivo que contém a interface do dispositivo a ser removida. Esse identificador normalmente é retornado por SetupDiGetClassDevs.
[in, out] DeviceInterfaceData
Um ponteiro para uma estrutura SP_DEVICE_INTERFACE_DATA que especifica a interface do dispositivo em DeviceInfoSet a ser removida. Esse ponteiro normalmente é retornado por SetupDiEnumDeviceInterfaces.
Depois que a interface é removida, essa função define o sinalizador SPINT_REMOVED em DeviceInterfaceData. Sinalizadores. Ele também limpa o sinalizador SPINT_ACTIVE, mas lembre-se de que esse sinalizador já deveria ter sido limpo antes de essa função ser chamada.
Valor retornado
SetupDiRemoveDeviceInterface retornará TRUE se a função for concluída sem erros. Se a função for concluída com um erro, ela retornará FALSE e o código de erro da falha poderá ser recuperado chamando GetLastError.
Comentários
O chamador dessa função deve ser membro do grupo Administradores.
SetupDiRemoveDeviceInterface remove a interface de dispositivo especificada do sistema. Isso inclui a exclusão da chave do Registro associada.
Chame SetupDiDeleteDeviceInterfaceData para excluir a interface de uma lista de informações do dispositivo.
Uma interface do dispositivo deve ser desabilitada para ser removida. Se a interface estiver habilitada, essa função falhará e GetLastError retornará ERROR_DEVICE_INTERFACE_ACTIVE. Desabilite uma interface usando qualquer mecanismo específico da interface fornecido (por exemplo, um IOCTL). Se o chamador não tiver como desabilitar uma interface e a interface precisar ser removida, o chamador deverá interromper o dispositivo subjacente usando SetupDiChangeState. Parar o dispositivo desabilita todas as interfaces expostas pelo dispositivo.
Requisitos
| Cliente mínimo com suporte | Disponível no Microsoft Windows 2000 e versões posteriores do Windows. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | setupapi.h (inclua Setupapi.h) |
| Biblioteca | Setupapi.lib |
| DLL | Setupapi.dll |