Função SetupDiInstallClassExA (setupapi.h)
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 da janela pai para 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. Sinalizadores podem ser OR zero ou bit a bit dos seguintes valores:
DI_NOVCP
Defina esse sinalizador se FileQueue for fornecido.
DI_NOVCP instrui a função SetupInstallFromInfSection 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 encontrar 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 de 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.
Valor de retorno
SetupDiInstallClassEx retornará TRUE se for bem-sucedido. Caso contrário, ele retorna FALSE e o erro registrado pode ser recuperado com uma chamada para GetLastError.
Observações
O chamador dessa função deve ser um membro do grupo Administradores.
SetupDiInstallClassEx normalmente é chamado por um instalador de classe para instalar uma nova classe de instalação de dispositivo ou uma nova classe de interface do dispositivo .
Nota
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. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Microsoft Windows 2000 e versões posteriores do Windows. |
| da Plataforma de Destino |
Área de trabalho |
| cabeçalho | setupapi.h (inclua Setupapi.h) |
| biblioteca | Setupapi.lib |