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

Confira também

SetupDiChangeState

SetupDiCreateDeviceInterface

SetupDiDeleteDeviceInterfaceData

SetupDiEnumDeviceInterfaces

SetupDiGetClassDevs