MsiConfigureProductExW 函数（msi.h）

项目
11/20/2024

MsiConfigureProductEx 函数安装或卸载产品。还可以指定产品命令行。

语法

UINT MsiConfigureProductExW(
  [in] LPCWSTR      szProduct,
  [in] int          iInstallLevel,
  [in] INSTALLSTATE eInstallState,
  [in] LPCWSTR      szCommandLine
);

参数

[in] szProduct

指定要配置的产品的代码示例。

[in] iInstallLevel

指定将产品安装到其默认状态时应安装多少产品。如果 eInstallState 参数设置为除 INSTALLSTATE_DEFAULT以外的任何值，则忽略 iInstallLevel 参数，并且已安装所有功能。

此参数可以是下列值之一。

价值	意义
INSTALLLEVEL_DEFAULT	将安装创作的默认功能。
INSTALLLEVEL_MINIMUM	仅安装所需的功能。可以在 INSTALLLEVEL_MINIMUM 和 INSTALLLEVEL_MAXIMUM 之间指定一个值，以安装一部分可用功能。
INSTALLLEVEL_MAXIMUM	已安装所有功能。可以在 INSTALLLEVEL_MINIMUM 和 INSTALLLEVEL_MAXIMUM 之间指定一个值，以安装一部分可用功能。

[in] eInstallState

指定产品的安装状态。此参数可以是下列值之一。

价值	意义
INSTALLSTATE_LOCAL	产品将随本地安装的所有功能一起安装。
INSTALLSTATE_ABSENT	产品已卸载。
INSTALLSTATE_SOURCE	将安装该产品，并安装从源运行的所有功能。
INSTALLSTATE_DEFAULT	产品将安装到功能表中指定的默认状态的所有功能。
INSTALLSTATE_ADVERTISED	产品已播发。

[in] szCommandLine

指定命令行属性设置。这应该是 Property=Setting Property=Setting格式的列表。有关详细信息，请参阅关于属性。

返回值

价值	意义
ERROR_INVALID_PARAMETER	将无效参数传递给函数。
ERROR_SUCCESS	函数成功。
与操作相关的错误	有关详细信息，请参阅错误代码。
初始化错误	发生与初始化相关的错误。

言论

作为 szCommandLine 传入的命令行可以包含任何功能安装选项属性。在这种情况下，传递的 eInstallState 必须 INSTALLSTATE_DEFAULT。

iInstallLevel 参数将被忽略，如果 eInstallState 参数设置为除 INSTALLSTATE_DEFAULT以外的任何其他值，则安装产品的所有功能。如果 eInstallState 参数未设置为 INSTALLSTATE_DEFAULT使用 msiConfigureFeature，则控制各个功能的安装。

MsiConfigureProductEx 函数使用当前设置显示用户界面。可以使用 MsiSetInternalUI、MsiSetExternalUI或 MsiSetExternalUIRecord更改用户界面设置。

注意

msi.h 标头将 MsiConfigureProductEx 定义为一个别名，该别名根据 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 Installer 版本所需的最低 Windows Service Pack 的信息，请参阅 Windows Installer Run-Time 要求。
目标平台	窗户
标头	msi.h
库	Msi.lib
DLL	Msi.dll