The MsiUseFeatureEx function increments the usage count for a particular feature and indicates the installation state for that feature. This function should be used to indicate an application's intent to use a feature.

Syntax

C++INSTALLSTATE MsiUseFeatureEx(
  __in  LPCTSTR szProduct,
  __in  LPCTSTR szFeature,
  __in  DWORD dwInstallMode,
  __in  DWORD dwReserved
);

Parameters

szProduct [in]

Specifies the product code for the product that owns the feature to be used.

szFeature [in]

Identifies the feature to be used.

dwInstallMode [in]

This parameter can have the following value.

Value	Meaning
INSTALLMODE_NODETECTION	Return value indicates the installation state.

 

dwReserved [in]

Reserved for future use. This value must be set to 0.

Return Value

Remarks

The MsiUseFeatureEx function should only be used on features known to be published. INSTALLSTATE_UNKNOWN indicates that the program is trying to use a feature that is not published. The application should determine whether the feature is published before calling MsiUseFeature by calling MsiQueryFeatureState or MsiEnumFeatures. The application should make these calls while it initializes. An application should only use features that are known to be published.

Requirements

See Also

Application-Only Functions

Send comments about this topic to Microsoft

Build date: 8/13/2009