Compartilhar via


Função InstallComponentW

Instala um pacote de exceção.

Sintaxe

void InstallComponentW(
  _In_           LPCWSTR InfPath,
  _In_opt_ const GUID    *CompGuid,
  _In_           DWORD   Flags,
  _In_opt_       INT     VerMajor,
  _In_opt_       INT     VerMinor,
  _In_opt_       INT     VerBuild,
  _In_opt_       INT     VerQFE,
  _In_opt_       LPCWSTR Name
);

Parâmetros

InfPath [in]

O caminho para a exceção INF a ser processada.

CompGuid [in, opcional]

O GUID do componente de exceção que está sendo instalado.

Sinalizadores [in]

Os sinalizadores usados para controlar os comportamentos de instalação. Esse parâmetro pode ser uma combinação dos seguintes valores.

Valor Significado
COMP_FLAGS_FORCE
0x00000020
Ignora a versão marcar em substituições de arquivo.
COMP_FLAGS_NEEDS_UNINSTALL
Fazer backup de arquivos que são atualizados para serem usados por uma desinstalação do componente.
COMP_FLAGS_NO_OVERWRITE
Ignora o backup de arquivos se a versão do componente Exception for igual a um componente instalado. Esse sinalizador é usado em um cenário de reinstalação.
COMP_FLAGS_NOUI
0x00000002
Suprime toda a interface do usuário.
COMP_FLAGS_UPDATE_DLLCACHE
Força o diretório DLLCACHE a ser atualizado quando um arquivo do sistema é atualizado.
COMP_FLAGS_USE_SVCPACK_CACHE
Usa arquivos armazenados em cache por uma instalação do service pack do Windows para substituir o backup de arquivos.

 

VerMajor [in, opcional]

A versão principal do componente Exception.

VerMinor [in, opcional]

A versão secundária do componente Exception.

VerBuild [in, opcional]

A versão de build do componente Exception.

VerQFE [in, opcional]

A revisão de hotfix do componente Exception.

Nome [in, opcional]

A cadeia de caracteres descritiva do componente mostrada pela caixa de diálogo Proteção de Arquivos do Windows se o sistema operacional detectar que um arquivo protegido da Proteção de Arquivos do Windows está danificado, adulterado ou corrompido.

Valor retornado

Essa função retorna um valor HRESULT (S_OK ou um código de falha). Um código de falha pode ser verificado em relação a um valor de 0x20000100 para determinar se a falha é porque uma reinicialização é necessária.

Comentários

Os pacotes de exceção são arquivos do sistema Windows que são lançados fora de uma versão completa do Pacote do Windows e que atualizam arquivos do sistema operacional. Os pacotes de exceção são criados apenas por equipes do sistema operacional que receberam autorização para atualizar arquivos do sistema Windows.

Para instalar e desinstalar arquivos que não são protegidos pela Proteção de Arquivos do Windows, use as funções documentadas em Funções de Instalação Geral. Para instalar drivers de dispositivo, os venders devem usar funções documentadas em Funções de Instalação de Dispositivo e PnP Configuration Manager Functions.

Essa função não tem biblioteca de importação ou arquivo de cabeçalho associado; você deve chamá-lo usando as funções LoadLibrary e GetProcAddress .

Requisitos

Requisito Valor
DLL
Msoobci.dll