Skip to content

Latest commit

 

History

History
103 lines (62 loc) · 6.28 KB

installer-providequalifiedcomponent.md

File metadata and controls

103 lines (62 loc) · 6.28 KB
Raw
description ms.assetid title ms.topic ms.date topic_type api_name api_type api_location
The ProvideQualifiedComponent method of the Installer object returns the full component path and performs any necessary installation. If necessary, this method prompts for the source and increments the usage count for the feature.
4f9a5094-1556-4d86-8b51-c8c3ce1cbed4
Installer.ProvideQualifiedComponent method
reference
05/31/2018
APIRef
kbSyntax
Installer.ProvideQualifiedComponent
COM
Msi.dll

Installer.ProvideQualifiedComponent method

The ProvideQualifiedComponent method of the Installer object returns the full component path and performs any necessary installation. If necessary, this method prompts for the source and increments the usage count for the feature.

Syntax

Installer.ProvideQualifiedComponent(
  Category,
  Qualifier,
  InstallMode
)

Parameters

Category

Specifies the component ID for the requested component. This may not be the GUID for the component itself but rather a server that provides the correct functionality, as in the ComponentId column of the PublishComponent table.

Qualifier

Specifies a qualifier into a list of advertising components (from PublishComponent table).

InstallMode

Defines the installation mode. This parameter can be one of the values shown in the following table.

InstallMode Meaning
msiInstallModeDefault
0
 Provides the component, performing any necessary installation.
msiInstallModeExisting
–1
 Provides the component only if the feature exists; otherwise returns an empty string. This mode verifies the existence of the component's key file.
msiInstallModeNoDetection
–2
 Provides the component only if the feature exists; otherwise returns an empty string. This mode only checks that the component is registered but does not verify the existence of the component's key file.
msiInstallModeNoSourceResolution
–3
 Provides the component path only if the feature exists with an InstallState parameter of msiInstallStateLocal. This checks the component's registration but does not verify the existence of the component's key file.
combination of the msiReinstallMode flags
 
 Calls ReinstallFeature to reinstall the feature using this parameter for the ReinstallMode parameter, and then provides the component.

 

Return value

This method does not return a value.

Requirements

Requirement Value
Version
 Windows Installer 5.0 on Windows Server 2012, Windows 8, Windows Server 2008 R2 or Windows 7. Windows Installer 4.0 or Windows Installer 4.5 on Windows Server 2008 or Windows Vista. Windows Installer on Windows Server 2003 or Windows XP
DLL
Msi.dll
IID
 IID_IInstaller is defined as 000C1090-0000-0000-C000-000000000046

See also

MsiProvideQualifiedComponent