MsiConfigureProductExW function (msi.h)
The MsiConfigureProductEx function installs or uninstalls a product. A product command line can also be specified.
UINT MsiConfigureProductExW( [in] LPCWSTR szProduct, [in] int iInstallLevel, [in] INSTALLSTATE eInstallState, [in] LPCWSTR szCommandLine );
Specifies the product code for the product to be configured.
Specifies how much of the product should be installed when installing the product to its default state. The iInstallLevel parameters are ignored, and all features are installed, if the eInstallState parameter is set to any value other than INSTALLSTATE_DEFAULT.
This parameter can be one of the following values.
Specifies the installation state for the product. This parameter can be one of the following values.
||The product is to be installed with all features installed locally.|
||The product is uninstalled.|
||The product is to be installed with all features installed to run from source.|
||The product is to be installed with all features installed to the default states specified in the Feature Table.|
||The product is advertised.|
Specifies the command-line property settings. This should be a list of the format Property=Setting Property=Setting. For more information, see About Properties.
||An invalid parameter is passed to the function.|
||The function succeeded.|
||For more information, see Error Codes.|
|An error relating to initialization occurred.|
The command line passed in as szCommandLine can contain any of the Feature Installation Options Properties. In this case, the eInstallState passed must be INSTALLSTATE_DEFAULT.
The iInstallLevel parameter is ignored and all features of the product are installed if the eInstallState parameter is set to any other value than INSTALLSTATE_DEFAULT. To control the installation of individual features when the eInstallState parameter is not set to INSTALLSTATE_DEFAULT use MsiConfigureFeature.
The msi.h header defines MsiConfigureProductEx as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
|Minimum supported client||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. See the Windows Installer Run-Time Requirements for information about the minimum Windows service pack that is required by a Windows Installer version.|