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
| 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 3.0 or later on Windows Server 2003, Windows XP, and Windows 2000 |
|---|---|
| DLL | Msi.dll |
| IID | IID_IProduct is defined as 000C10A0-0000-0000-C000-000000000046 |
See Also
Send comments about this topic to Microsoft
Build date: 8/13/2009
© 2009 Microsoft Corporation. All rights reserved.