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

Syntax

C++UINT MsiConfigureFeature(
  __in  LPCTSTR szProduct,
  __in  LPCTSTR szFeature,
  __in  INSTALLSTATE eInstallState
);

Parameters

szProduct [in]

Specifies the product code for the product to be configured.

szFeature [in]

Specifies the feature ID for the feature to be configured.

eInstallState [in]

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.

 

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. See the Windows Installer Run-Time Requirements for information about the minimum Windows service pack that is required by a Windows Installer version.
Header	Msi.h
Library	Msi.lib
DLL	Msi.dll
Unicode and ANSI names	MsiConfigureFeatureW (Unicode) and MsiConfigureFeatureA (ANSI)

See Also

Displayed Error Messages

Error Codes

Initialization Error

Installation and Configuration Functions

Multiple-Package Installations

Send comments about this topic to Microsoft

Build date: 8/13/2009