Função SetupDiUnremoveDevice (setupapi.h)

  • Artigo

A função SetupDiUnremoveDevice é o manipulador padrão para a solicitação de instalação DIF_UNREMOVE .

Sintaxe

WINSETUPAPI BOOL SetupDiUnremoveDevice(
  [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 um dispositivo para restaurar e reiniciar.

[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 DeviceInfoData.DevInst pode ser atualizado com um novo valor de identificador no retorno.

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

SetupDiUnremoveDevice restaura um dispositivo para um perfil de hardware. Essa função inicia o dispositivo, se possível, ou define um sinalizador nos parâmetros de instalação do dispositivo que eventualmente faz com que o usuário seja solicitado a desligar o sistema.

Nota Somente um instalador de classe deve chamar SetupDiUnremoveDevice e somente nessas situações em que o instalador de classe deve executar operações de cancelamento de modificação de dispositivo após SetupDiUnremoveDevice concluir a operação padrão de cancelamento de modificação do dispositivo. Nessas situações, o instalador de classe deve chamar diretamente SetupDiUnremoveDevice quando o instalador processa uma solicitação de DIF_UNREMOVE. Para obter mais informações sobre como chamar o manipulador padrão, consulte Chamando manipuladores de código DIF padrão.
 
O dispositivo que está sendo restaurado deve ter parâmetros de instalação de classe para DIF_UNREMOVE ou a função falha e GetLastError retorna ERROR_NO_CLASSINSTALL_PARAMS.

O DeviceInfoSet deve conter apenas elementos no computador local.

O chamador de SetupDiUnremoveDevice deve ser membro do grupo Administradores.

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

DIF_UNREMOVE

SP_DEVINFO_DATA

SetupDiRemoveDevice