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。

十进制值 含义
2
INSTALLSTATE_ADVERTISED
 可以播发该功能。
4
INSTALLSTATE_ABSENT
 该功能可能不存在。
8
INSTALLSTATE_LOCAL
 此功能可以安装在本地驱动器上。
16
INSTALLSTATE_SOURCE
 该功能可配置为从源、CD-ROM 或网络运行。
32
INSTALLSTATE_DEFAULT
 该功能可配置为使用默认位置：本地或源。

返回值

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 后，可以使用条件语句来测试功能的有效安装状态。 例如，以下对 MsiGetFeatureValidStates 的 调用获取 Feature1 的安装状态。 
MsiGetFeatureValidStates(hProduct, "Feature1", &dwValidStates);

如果 Feature1 具有值为 0 的属性 (偏向于本地) ，而 Feature1 具有一个属性为 0 的组件， (本地仅) ，则调用后的 dwValidStates 值为 14。 这表示INSTALLSTATE_LOCAL、INSTALLSTATE_ABSENT和INSTALLSTATE_ADVERTISED是 Feature1 的有效状态。 如果 local 是此功能的有效状态，则以下条件语句的计算结果为 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
目标平台 Windows
标头 msiquery.h
Library Msi.lib
DLL Msi.dll

另请参阅

安装程序选择函数

将 Null 作为 Windows Installer 函数的参数传递