Função SetupDiInstallDriverFiles (setupapi.h)

  • Artigo

A função SetupDiInstallDriverFiles é o manipulador padrão para a solicitação de instalação DIF_INSTALLDEVICEFILES .

Sintaxe

WINSETUPAPI BOOL SetupDiInstallDriverFiles(
  [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 o elemento de informações do dispositivo que representa o dispositivo para o qual os arquivos serão instalados. 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

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

Comentários

O chamador de SetupDiInstallDriverFiles deverá ser membro do grupo Administradores se essa função estiver sendo usada para instalar arquivos. No entanto, se essa função estiver sendo usada para criar uma fila de arquivos, a associação no grupo Administradores não será necessária.

Nota Somente um instalador de classe deve chamar SetupDiInstallDriverFiles e somente nas situações em que o instalador de classe deve executar operações de instalação de arquivo de driver depois que SetupDiInstallDriverFiles concluir a operação de instalação de arquivo de driver padrão. Nessas situações, o instalador de classe deve chamar diretamente SetupDiInstallDriverFiles quando o instalador processa uma solicitação de DIF_INSTALLDEVICEFILES. Para obter mais informações sobre como chamar o manipulador padrão, consulte Chamando manipuladores de código DIF padrão.
 
A operação de SetupDiInstallDriverFiles é semelhante à função SetupDiInstallDevice . No entanto, essa função executa apenas as operações de cópia de arquivo executadas por SetupDiInstallDevice.

Um driver deve ser selecionado para o conjunto de informações do dispositivo ou elemento especificado antes que essa função seja chamada.

Essa função processa as entradas CopyFiles, Delfiles e Renfiles no arquivo INF selecionado.

O 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

SetupDiCallClassInstaller

SetupDiInstallDevice