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

Confira também

MsiProvideComponent