Função SetupDiInstallClassExA (setupapi.h)

  • Artigo

A função SetupDiInstallClassEx instala um instalador de classe ou uma classe de interface.

Sintaxe

WINSETUPAPI BOOL SetupDiInstallClassExA(
  [in, optional] HWND       hwndParent,
  [in, optional] PCSTR      InfFileName,
  [in]           DWORD      Flags,
  [in, optional] HSPFILEQ   FileQueue,
  [in, optional] const GUID *InterfaceClassGuid,
                 PVOID      Reserved1,
                 PVOID      Reserved2
);

Parâmetros

[in, optional] hwndParent

O identificador para a janela pai de qualquer interface do usuário usada para instalar essa classe. Esse parâmetro é opcional e pode ser NULL.

[in, optional] InfFileName

Um ponteiro para uma cadeia de caracteres terminada em NULL que contém o nome de um arquivo INF. Esse parâmetro é opcional e pode ser NULL. Se essa função estiver sendo usada para instalar um instalador de classe, o arquivo INF conterá uma seção INF ClassInstall32 e esse parâmetro não deverá ser NULL.

Se essa função estiver sendo usada para instalar uma classe de interface, o arquivo INF conterá uma seção INF InterfaceInstall32.

[in] Flags

Um valor do tipo DWORD que controla o processo de instalação. Os sinalizadores podem ser zero ou um OR bit a bit dos seguintes valores:

DI_NOVCP

Defina esse sinalizador se FileQueue for fornecido.

DI_NOVCP instrui a função SetupInstallFromInfSection a não criar uma fila própria e usar a fila fornecida pelo chamador.

Se esse sinalizador estiver definido, os arquivos não serão copiados apenas na fila.

Para obter mais informações sobre a função SetupInstallFromInfSection, consulte a documentação do SDK do Microsoft Windows.

DI_NOBROWSE

Defina esse sinalizador para desabilitar a navegação se uma operação de cópia não puder localizar um arquivo especificado. Se o chamador fornecer uma fila de arquivos, esse sinalizador será ignorado.

DI_FORCECOPY

Defina esse sinalizador para sempre copiar arquivos, mesmo que eles já estejam presentes no computador do usuário. Se o chamador fornecer uma fila de arquivos, esse sinalizador será ignorado.

DI_QUIETINSTALL

Defina esse sinalizador para suprimir a interface do usuário, a menos que seja absolutamente necessário. Por exemplo, não exiba a caixa de diálogo de progresso. Se o chamador fornecer uma fila de arquivos, esse sinalizador será ignorado.

[in, optional] FileQueue

Se o sinalizador DI_NOVCP estiver definido, esse parâmetro fornecerá um identificador para uma fila de arquivos em que as operações de arquivo devem ser enfileiradas, mas não confirmadas.

[in, optional] InterfaceClassGuid

Um ponteiro para um GUID que identifica a classe de interface a ser instalada. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for especificado, essa função estará sendo usada para instalar a classe de interface representada pelo GUID. Se esse parâmetro for NULL, essa função estará sendo usada para instalar um instalador de classe.

Reserved1

Reservado. Deve ser zero.

Reserved2

Reservado. Deve ser zero.

Retornar valor

SetupDiInstallClassEx retornará TRUE se for bem-sucedido. Caso contrário, ele retornará FALSE e o erro registrado poderá ser recuperado com uma chamada para GetLastError.

Comentários

O chamador dessa função deve ser membro do grupo Administradores.

SetupDiInstallClassEx normalmente é chamado por um instalador de classe para instalar uma nova classe de configuração de dispositivo ou uma nova classe de interface de dispositivo.

Nota Uma classe de interface também pode ser instalada automaticamente chamando SetupDiInstallDeviceInterfaces para instalar as interfaces de dispositivo de um dispositivo.
 

Observação

O cabeçalho setupapi.h define SetupDiInstallClassEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de funçã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

Confira também

SetupDiCallClassInstaller

SetupDiInstallDeviceInterfaces