通过

Product.InstallProperty 方法

  • 项目

InstallProperty 属性是此产品实例的属性的值。

此属性调用 MsiGetProductInfoEx 函数，其中 Product 对象的 ProductCode、UserSid 和 Context 以及请求的属性作为参数。

语法

Product.InstallProperty(
  property
)

参数

property

指定要检索的属性。 只能从已安装的应用程序检索以下列表中的属性。 请注意，必需属性保证可用，但其他属性仅在该属性已设置时才可用。 有关如何设置每个属性的信息，请参阅指向安装程序属性的指示链接。

安装的属性 含义
INSTALLPROPERTY_PRODUCTSTATE
 以字符串形式返回的产品的状态，“1”表示产品已播发，“5”表示产品已安装。
INSTALLPROPERTY_HELPLINK
 支持链接。 有关详细信息，请参阅 ARPHELPLINK 属性。
INSTALLPROPERTY_HELPTELEPHONE
 支持电话。 有关详细信息，请参阅 ARPHELPTELEPHONE 属性。
INSTALLPROPERTY_INSTALLDATE
 此产品最后一次接受服务的时间。 每次从产品应用或移除修补程序或使用 /v 命令行选项修复产品时，都会替换此属性的值。 如果产品未接受任何修复或修补，则此属性包含在此计算机上安装该产品的时间。
INSTALLPROPERTY_INSTALLEDPRODUCTNAME
 已安装的产品名称。 有关详细信息，请参阅 ProductName 属性。
INSTALLPROPERTY_INSTALLLOCATION
 安装位置。 有关详细信息，请参阅 ARPINSTALLLOCATION 属性。
INSTALLPROPERTY_INSTALLSOURCE
 安装源。 有关详细信息，请参阅 SourceDir 属性。
INSTALLPROPERTY_LOCALPACKAGE
 本地缓存包。
INSTALLPROPERTY_PUBLISHER
 发行者。 有关详细信息，请参阅 Manufacturer 属性。
INSTALLPROPERTY_URLINFOABOUT
 URL 信息。 有关详细信息，请参阅 ARPURLINFOABOUT 属性。
INSTALLPROPERTY_URLUPDATEINFO
 URL 更新信息。 有关详细信息，请参阅 ARPURLUPDATEINFO 属性。
INSTALLPROPERTY_VERSIONMINOR
 派生自 ProductVersion 属性的次要产品版本。
INSTALLPROPERTY_VERSIONMAJOR
 派生自 ProductVersion 属性的主要产品版本。
INSTALLPROPERTY_VERSIONSTRING
 产品版本。 有关详细信息，请参阅 ProductVersion 属性。

 

若要从已安装的应用程序检索产品 ID、注册所有者或注册公司，请将 property 设置为以下文本字符串值之一。

值 说明
ProductID 产品标识符。 有关详细信息，请参阅 ProductID 属性。
RegCompany 注册以使用此产品的公司。
RegOwner 注册以使用此产品的所有者。

 

若要检索产品的实例类型，请将 property 设置为以下值。 此属性可用于已播发或已安装的产品。

值 说明
InstanceType 值缺失或值为 0 表示产品安装正常。 值为 1 表示产品使用多实例转换和 MSINEWINSTANCE 属性安装。 适用于运行 Windows Server 2003 或具有 SP1 的 Windows XP 的安装程序。 有关详细信息，请参阅安装产品和修补程序的多个实例。

 

还可以从播发的应用程序检索以下列表中的属性。 对于在当前用户帐户以外的用户帐户的按用户非托管上下文中安装的产品实例，无法检索这些属性。

播发的属性 说明
INSTALLPROPERTY_TRANSFORMS 转换。
INSTALLPROPERTY_LANGUAGE 产品语言。
INSTALLPROPERTY_PRODUCTNAME 人工可读的产品名称。 有关详细信息，请参阅 ProductName 属性。
INSTALLPROPERTY_ASSIGNMENTTYPE 等于零 (0) 表示该产品已播发，或已按用户安装。 等于一 (1) 表示该产品已播发，或已为所有用户按计算机安装。
INSTALLPROPERTY_PACKAGECODE 从中安装此产品的包的标识符。 有关详细信息，请参阅包代码。
INSTALLPROPERTY_VERSION 派生自 ProductVersion 属性的产品版本。
INSTALLPROPERTY_PRODUCTICON 包的主图标。 有关详细信息，请参阅 ARPPRODUCTICON 属性。
INSTALLPROPERTY_PACKAGENAME 原始安装包的名称。
INSTALLPROPERTY_AUTHORIZED_LUA_APP 值为 1 表示产品可由非管理员使用用户帐户控制 (UAC) 修补进行维护。 值缺失或值为 0 表示未启用最小特权修补。 适用于 Windows Installer 3.0 及更高版本。

 

返回值

此方法不返回值。

备注

如果调用成功，则属性包含字符串格式的值。

要求

要求 值
版本
 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 2000 上的 Windows Installer 3.0 或更高版本
DLL
Msi.dll
IID
 IID_IProduct 定义为 000C10A0-0000-0000-C000-000000000046

另请参阅

产品

在 Windows Installer 2.0 及更低版本中不受支持