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

Script
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

Version	Windows Installer 5.0 on 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, Windows XP, and Windows 2000
DLL	Msi.dll
IID	IID_IInstaller is defined as 000C1090-0000-0000-C000-000000000046

See Also

MsiProvideQualifiedComponent

Send comments about this topic to Microsoft

Build date: 8/13/2009