MsiConfigureFeature Function

Windows Installer

MsiConfigureFeature Function

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

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. See the Windows Installer Run-Time Requirements for information about the minimum Windows service pack that is required by a Windows Installer version.
HeaderMsi.h
LibraryMsi.lib
DLLMsi.dll
Unicode and ANSI namesMsiConfigureFeatureW (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

© 2009 Microsoft Corporation. All rights reserved.