Método Installer.ProvideComponent

O método ProvideComponent do objeto Installer retorna o caminho completo do componente e executa qualquer instalação necessária. Se necessário, o método ProvideComponent do objeto Installer solicita a origem e incrementa a contagem de uso para o recurso.

Sintaxe

Installer.ProvideComponent(
  Product,
  Feature,
  Component,
  InstallMode
)

Parâmetros

Product

Especifica o código de produto do produto.

Recurso

Especifica a ID do recurso que contém o componente.

Componente

Especifica o código do componente.

InstallMode

Define o modo de instalação. Este parâmetro poderá ser um dos valores mostrados na tabela a seguir.

Nome	Significado
msiInstallModeDefault 0	Fornece o caminho do componente, executando qualquer instalação, se necessário.
msiInstallModeExisting –1	Fornece o caminho do componente somente se o recurso existir; caso contrário, retorna uma cadeia de caracteres vazia. Esse modo verifica a existência do arquivo chave do componente.
msiInstallModeNoDetection –2	Fornece o caminho do componente somente se o recurso existir. Caso contrário, ele retorna uma cadeia de caracteres vazia. Esse modo verifica o registro do componente, mas não verifica a existência do arquivo de chave do componente.
msiInstallModeNoSourceResolution –3	Fornece o caminho do componente somente se o recurso existir com um parâmetro InstallState de msiInstallStateLocal. Isso verifica o registro do componente, mas não verifica a existência do arquivo de chave do componente.
combinação dos sinalizadores msiReinstallMode	Chama o ReinstallFeature para reinstalar o recurso usando esse parâmetro para o parâmetro ReinstallMode e fornece o componente.

 

Valor retornado

Esse método não retorna um valor.

Comentários

O método ProvideComponent combina a funcionalidade de UseFeature, ConfigureFeature e ComponentPath. O método ProvideComponent simplifica a sequência de chamadas, mas também incrementa a contagem de uso e deve ser usado com cuidado para evitar contagens de uso imprecisas. O método ProvideComponent também fornece menos flexibilidade do que uma série de chamadas individuais para os métodos e propriedades mencionados anteriormente.

Se o aplicativo estiver se recuperando de uma situação inesperada, o aplicativo provavelmente já chamou UseFeature e incrementou a contagem de uso. Nesse caso, o aplicativo deve evitar incrementar a contagem de uso chamando o método ConfigureFeature em vez do método ProvideComponent.

A opção msiInstallModeExisting não pode ser usada em combinação com sinalizadores msiReinstallMode.

Requisitos

Requisito	Valor
Versão	Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP
DLL	Msi.dll
IID	O IID_IInstaller é definido como 000C1090-0000-0000-C000-000000000046

Confira também

MsiProvideComponent