MsiConfigureFeatureW function (msi.h)

The MsiConfigureFeature function configures the installed state for a product feature.

Syntax

UINT MsiConfigureFeatureW(
  [in] LPCWSTR      szProduct,
  [in] LPCWSTR      szFeature,
  [in] INSTALLSTATE eInstallState
);

Parameters

[in] szProduct

Specifies the product code for the product to be configured.

[in] szFeature

Specifies the feature ID for the feature to be configured.

[in] eInstallState

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

Value	Meaning
INSTALLSTATE_ADVERTISED	The feature is advertised
INSTALLSTATE_LOCAL	The feature is installed locally.
INSTALLSTATE_ABSENT	The feature is uninstalled.
INSTALLSTATE_SOURCE	The feature is installed to run from source.
INSTALLSTATE_DEFAULT	The feature is installed to its default location.

Return value

Value	Meaning
ERROR_INVALID_PARAMETER	An invalid parameter is passed to the function.
ERROR_SUCCESS	The function succeeds.
An error relating to an action	For more information, see Error Codes.
Initialization Error	An error that relates to the initialization has occurred.

Remarks

Note

The msi.h header defines MsiConfigureFeature as an alias that 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 is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement	Value
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. Windows Installer on Windows Server 2003 or Windows XP. See the Windows Installer Run-Time Requirements for information about the minimum Windows service pack that is required by a Windows Installer version.
Target Platform	Windows
Header	msi.h
Library	Msi.lib
DLL	Msi.dll

See also

Displayed Error Messages

Error Codes

Initialization Error

Installation and Configuration Functions

Multiple-Package Installations