Função SetupDiInstallClassW (setupapi.h)

Artigo
11/20/2024

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

Sintaxe

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

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] 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 na documentação do SDK do Microsoft Windows) 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 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.

Valor de retorno

A função retornará TRUE se for bem-sucedida. 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.

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.

Nota

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 do 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

Consulte também

setupDiCallClassInstaller

SetupDiInstallClassEx

Compartilhar via