MsiGetFeatureValidStatesA 函数 （msiquery.h）
MsiGetFeatureValidStates 函数返回有效的安装状态。
语法
UINT MsiGetFeatureValidStatesA(
[in] MSIHANDLE hInstall,
[in] LPCSTR szFeature,
[out] LPDWORD lpInstallStates
);
参数
[in] hInstall
对提供给 DLL 自定义操作的安装句柄，或通过 MsiOpenPackage、MsiOpenPackageEx或 MsiOpenProduct获取的安装句柄。
[in] szFeature
指定功能名称。
[out] lpInstallStates
接收保存有效安装状态的位置。 对于每个有效的安装状态，安装程序会将 pInstallState 设置为以下值的组合。 此参数不应为 null。
返回值
MsiGetFeatureValidStates 函数返回以下值：
言论
请参阅 从程序调用数据库函数。
MsiGetFeatureValidStates 函数通过查询链接到指定功能的所有组件来确定状态有效性，而无需考虑任何组件的当前安装状态。
功能可能的有效状态按如下方式确定：
- 如果该功能不包含组件，则INSTALLSTATE_LOCAL和INSTALLSTATE_SOURCE都是该功能的有效状态。
- 如果功能的至少一个组件具有 msidbComponentAttributesLocalOnly 或 msidbComponentAttributesOptional 的属性，INSTALLSTATE_LOCAL是该功能的有效状态。
- 如果功能的至少一个组件具有 msidbComponentAttributesSourceOnly 或 msidbComponentAttributesOptional 的属性，则INSTALLSTATE_SOURCE是该功能的有效状态。
- 如果修补或从压缩源修补属于该功能的组件的文件，则INSTALLSTATE_SOURCE不包括为该功能的有效状态。
- 如果功能禁止播发（msidbFeatureAttributesDisallowAdvertise）或该功能需要平台支持播发（msidbFeatureAttributesNoUnsupportedAdvertise），并且平台不支持它，则INSTALLSTATE_ADVERTISE不是有效状态。
- 如果功能的属性不包含 msidbFeatureAttributesUIDisallowAbsent，则INSTALLSTATE_ABSENT是该功能的有效状态。
- 标记为遵循父功能（msidbFeatureAttributesFollowParent）的子功能的有效状态基于父功能的操作或已安装状态。
MsiGetFeatureValidStates(hProduct, "Feature1", &dwValidStates);
如果 Feature1 具有值为 0 的属性（偏向本地），并且 Feature1 具有值 0（仅限本地）的属性的一个组件，则调用后的 dwValidStates 值为 14。 这表示INSTALLSTATE_LOCAL、INSTALLSTATE_ABSENT和INSTALLSTATE_ADVERTISED是 Feature1 的有效状态。 如果本地是此功能的有效状态，则以下条件语句的计算结果为 True。
（（dwValidStates & （1 << INSTALLSTATE_LOCAL） = = （ 1 << INSTALLSTATE_LOCAL） ）
如果函数失败，可以使用 MsiGetLastErrorRecord获取扩展错误信息。
注意
msiquery.h 标头将 MsiGetFeatureValidStates 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows Server 2012、Windows 8、Windows Server 2008 R2 或 Windows 7 上的 Windows Installer 5.0。 Windows Server 2008 或 Windows Vista 上的 Windows Installer 4.0 或 Windows Installer 4.5。 Windows Server 2003 或 Windows XP 上的 Windows Installer |
| 目标平台 | 窗户 |
| 标头 | msiquery.h |
| 库 | Msi.lib |
| DLL | Msi.dll |