Função SetupDiInstallClassA (setupapi.h)

A função SetupDiInstallClass instala a seção ClassInstall32 do arquivo INF especificado.

Sintaxe

WINSETUPAPI BOOL SetupDiInstallClassA(
  [in, optional] HWND     hwndParent,
  [in]           PCSTR    InfFileName,
  [in]           DWORD    Flags,
  [in, optional] HSPFILEQ FileQueue
);

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] InfFileName

Um ponteiro para uma cadeia de caracteres terminada em NULL que contém o nome do arquivo INF que contém uma seção INF ClassInstall32.

[in] Flags

Esses sinalizadores controlam o processo de instalação. Pode ser uma combinação do seguinte:

DI_NOVCP

Defina esse sinalizador se FileQueue for fornecido. DI_NOVCP instrui a função SetupInstallFromInfSection (descrita em SDK do Microsoft Windows documentação) 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.

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.

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 dessa função deve ser membro do grupo Administradores.

Essa função é chamada por um instalador de classe quando instala um dispositivo de uma nova classe de dispositivo.

Para instalar uma classe de interface ou uma classe de dispositivo, use SetupDiInstallClassEx.

Observação

O cabeçalho setupapi.h define SetupDiInstallClass 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

SetupDiInstallClassEx