Product.FeatureState Method

Windows Installer

Product.FeatureState Method

The FeatureState property is the installation state of the feature for the instance of this product. This is a read-only property.

This property calls MsiQueryFeatureStateEx, with the ProductCode, UserSid and Context of the object. The feature Id is provided as a parameter.

Syntax

Script
FeatureState(
  FeatureId
)

Parameters

FeatureId

Feature Id appearing in the Feature column of the Feature Table.

Return Value

This method does not return a value.

Remarks

If the call succeeds, the property contains the value as a DWORD.

State Meaning
INSTALLSTATE_ADVERTISED This feature is advertised.
INSTALLSTATE_LOCAL The feature is installed locally.
INSTALLSTATE_SOURCE The feature is installed to run from source.

 

If the call fails, the property contains an error code from MsiQueryFeatureStateEx.

Error Meaning
ERROR_ACCESS_DENIED The calling process must have administrative privileges to get information for a product installed for a user other than the current user.
ERROR_BAD_CONFIGURATION The configuration data is corrupt.
ERROR_INVALID_PARAMETER An invalid parameter was passed to the function.
ERROR_SUCCESS The function completed successfully.
ERROR_UNKNOWN_FEATURE The feature ID does not identify a known feature.
ERROR_UNKNOWN_PRODUCT The product code does not identify a known product.
ERROR_FUNCTION_FAILED An unexpected internal failure.

 

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 3.0 or later on Windows Server 2003, Windows XP, and Windows 2000
DLLMsi.dll
IIDIID_IProduct is defined as 000C10A0-0000-0000-C000-000000000046

See Also

Product
MsiQueryFeatureStateEx

Send comments about this topic to Microsoft

Build date: 8/13/2009

© 2009 Microsoft Corporation. All rights reserved.