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

Requirements

See Also

MsiProvideQualifiedComponent

Send comments about this topic to Microsoft

Build date: 8/13/2009