Função SetupDiRegisterCoDeviceInstallers (setupapi.h)

  • Artigo

A função SetupDiRegisterCoDeviceInstallers é o manipulador padrão para DIF_REGISTER_COINSTALLERS.

Sintaxe

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

Parâmetros

[in] DeviceInfoSet

Um identificador para o conjunto de informações do dispositivo que contém um elemento de informações do dispositivo que representa o dispositivo para o qual os co-instaladores devem ser registrados. O conjunto de informações do dispositivo não deve conter elementos remotos.

[in] DeviceInfoData

Um ponteiro para uma estrutura SP_DEVINFO_DATA que especifica o elemento de informações do dispositivo em DeviceInfoSet.

Retornar valor

SetupDiRegisterCoDeviceInstallers retornará TRUE se a função for bem-sucedida. Se a função retornar FALSE, chame GetLastError para obter informações de erro estendidas.

Comentários

O chamador de SetupDiRegisterCoDeviceInstallers deve ser membro do grupo Administradores.

Nota Somente um instalador de classe deve chamar SetupDiRegisterCoDeviceInstallers e somente nas situações em que o instalador de classe deve executar operações de registro de co-instalador depois que SetupDiRegisterCoDeviceInstallers concluir a operação de registro de co-instalador padrão. Nessas situações, o instalador de classe deve chamar diretamente SetupDiRegisterCoDeviceInstallers quando o instalador processa uma solicitação de DIF_REGISTER_COINSTALLERS. Para obter mais informações sobre como chamar o manipulador padrão, consulte Chamando manipuladores de código DIF padrão.
 
SetupDiRegisterCoDeviceInstallers lê o arquivo INF do dispositivo especificado por DeviceInfoData e cria entradas do Registro para registrar quaisquer co-instaladores específicos do dispositivo listados no arquivo INF. Os co-instaladores são listados em uma seção INF DDInstall.CoInstallers. Essa função também copia os arquivos para os co-instaladores, a menos que o sinalizador DI_NOFILECOPY esteja definido.

Se não houver nenhum driver selecionado ou o dispositivo tiver um arquivo INF para Windows 9x ou Millennium Edition, essa função não registrará nenhum co-instalador.

Registrar um novo co-instalador específico do dispositivo invalida a lista atual de co-instaladores do Instalador de Dispositivos. Após um registro bem-sucedido, o Instalador de Dispositivo atualiza sua lista de co-instaladores.

Essa função registra apenas os co-instaladores específicos do dispositivo, não os co-instaladores de classe.

Para obter mais informações sobre como gravar e registrar co-instaladores específicos do dispositivo, consulte Escrevendo um co-instalador.

O conjunto de informações do dispositivo especificado por DeviceInfoSet deve conter apenas elementos no computador local.

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_REGISTER_COINSTALLERS

SetupDiCallClassInstaller