Método Installer.ProvideQualifiedComponent

Artigo
06/13/2023

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

Sintaxe

Installer.ProvideQualifiedComponent(
  Category,
  Qualifier,
  InstallMode
)

Parâmetros

Categoria

Especifica a ID do componente para o componente solicitado. Esse pode não ser o GUID para o componente em si, mas sim um servidor que fornece a funcionalidade correta, como na coluna ComponentId da Tabela PublishComponent.

Qualificador

Especifica um qualificador em uma lista de componentes de publicidade (da Tabela PublishComponent).

InstallMode

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

InstallMode	Significado
msiInstallModeDefault 0	Fornece o componente, executando qualquer instalação necessária.
msiInstallModeExisting –1	Fornece o 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 componente somente se o recurso existir, caso contrário, retorna uma cadeia de caracteres vazia. Esse modo verifica apenas se o componente está registrado, mas não verifica a existência do arquivo 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.

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

MsiProvideQualifiedComponent

Compartilhar via