Installer.ConfigureProduct Method

Windows Installer

Installer.ConfigureProduct Method

The ConfigureProduct method of the Installer object installs or uninstalls a product.

Syntax

Script
ConfigureProduct(
  Product,
  InstallLevel,
  InstallState
)

Parameters

Product

Specifies the product code of the product.

InstallLevel

Specifies the default installation configuration of the product. The InstallLevel parameter is ignored and all features are installed if the InstallState parameter is set to any other value than msiInstallStateDefault.

This parameter must be either 0 (install using authored feature levels), 65535 (install all features), or a value between 0 and 65535 to install a subset of available features.

InstallState

Specifies the installation state for the feature. This parameter must be one of the following values.

Value Meaning
msiInstallStateAdvertised

The feature is advertised

msiInstallStateLocal

The feature is installed locally.

msiInstallStateAbsent

The feature is uninstalled.

msiInstallStateSource

The feature is installed to run from source.

msiInstallStateDefault

The feature is installed to its default location.

 

Return Value

This method does not return a value.

Remarks

The ConfigureProduct method displays the user interface using current settings. User interface settings can be changed by modifying the UILevel property (Installer object) before calling the ConfigureProduct method.

If the InstallState parameter is set to any other value than msiInstallStateDefault, the InstallLevel parameter is ignored and all features of the product are installed. Use the ConfigureFeature method to control the installation of individual features when the InstallState parameter is not set to msiInstallStateDefault.

Requirements

VersionWindows 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
DLLMsi.dll
IIDIID_IInstaller is defined as 000C1090-0000-0000-C000-000000000046

See Also

MsiConfigureProduct
Installation and Configuration Functions

Send comments about this topic to Microsoft

Build date: 8/13/2009

© 2009 Microsoft Corporation. All rights reserved.