Função SetupDiRemoveDevice (setupapi.h)

  • Artigo

A função SetupDiRemoveDevice é o manipulador padrão para a solicitação de instalação DIF_REMOVE .

Sintaxe

WINSETUPAPI BOOL SetupDiRemoveDevice(
  [in]      HDEVINFO         DeviceInfoSet,
  [in, out] PSP_DEVINFO_DATA DeviceInfoData
);

Parâmetros

[in] DeviceInfoSet

Um identificador para um conjunto de informações de dispositivo para o sistema local que contém um elemento de informações do dispositivo que representa o dispositivo a ser removido.

[in, out] DeviceInfoData

Um ponteiro para uma estrutura SP_DEVINFO_DATA que especifica o elemento de informações do dispositivo em DeviceInfoSet. Esse é um parâmetro IN-OUT porque DeviceInfoSet. DevInst pode ser atualizado com um novo valor de identificador no retorno. Se essa for uma remoção global ou a última remoção específica do perfil de hardware, todos os rastreamentos da instância do dispositivo serão excluídos do registro e o identificador será NULL.

Retornar valor

A função retornará TRUE se for bem-sucedida. Caso contrário, ele retornará FALSE e o erro registrado poderá ser recuperado por uma chamada para GetLastError.

Comentários

SetupDiRemoveDevice remove o dispositivo do sistema. Ele exclui as chaves do registro de hardware e software do dispositivo e todas as chaves do Registro específicas do perfil de hardware (chaves do Registro específicas da configuração). Essa função interromperá dinamicamente o dispositivo se seu DevInst estiver ativo e essa for uma remoção global ou a última remoção específica da configuração. Se o dispositivo não puder ser interrompido dinamicamente, os sinalizadores serão definidos no bloco Instalar Parâmetro do conjunto de informações do dispositivo que eventualmente fará com que o usuário seja solicitado a reiniciar o computador.

A remoção do dispositivo é global para todos os perfis de hardware ou específica de um perfil de hardware, conforme especificado pelo membro Scope da estrutura SP_REMOVEDEVICE_PARAMS que fornece os parâmetros de instalação de classe para a solicitação de DIF_REMOVE. A remoção específica da configuração só é apropriada para dispositivos enumerados raiz e só deve ser solicitada pelo código do sistema.

O chamador de SetupDiRemoveDevice deve ser membro do grupo Administradores.

Nota Somente um instalador de classe deve chamar SetupDiRemoveDevice e somente nas situações em que o instalador de classe deve executar operações de remoção de dispositivo após SetupDiRemoveDevice concluir a operação de remoção de dispositivo padrão. Nessas situações, o instalador de classe deve chamar diretamente SetupDiRemoveDevice quando o instalador processa uma solicitação de DIF_REMOVE. Para obter mais informações sobre como chamar o manipulador padrão, consulte Chamando manipuladores de código DIF padrão.
 

Requisitos

Requisito Valor
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

SP_DEVINFO_DATA

SP_REMOVEDEVICE_PARAMS