Installer 对象

最初必须创建 Installer 对象才能加载 COM 访问安装程序函数所需的自动化支持。 此对象提供包装器来创建顶级对象并访问其方法。

可以从 ProgId“WindowsInstaller.Installer”创建 Installer 对象。

成员

Installer 对象包含以下类型的成员：

• 方法
• 属性

方法

Installer 对象具有以下方法。

方法	说明
AddSource	在源列表中，将源添加到有效网络源列表。
AdvertiseProduct	播发安装包。
AdvertiseScript	播发安装包。
ApplyMultiplePatches	将一个或多个修补程序应用于有资格接收修补程序的产品。 将 PATCH 属性设置为提供的修补程序包的路径。
ApplyPatch	对于修补程序包所列出的有资格接收修补程序的每个产品，调用安装并将 PATCH 设置为修补程序包的路径。
ClearSourceList	从源列表中移除所有网络源。
CollectUserInfo	调用一个用户界面向导序列，用于收集和存储用户信息和产品代码。
ConfigureFeature	配置产品功能的安装状态。
ConfigureProduct	安装或卸载产品。
CreateAdvertiseScript	生成播发脚本。
CreateRecord	返回具有所请求字段数的新 Record 对象。
EnableLog	为当前进程空间中的所有后续安装会话启用所选消息类型的日志记录。
ExtractPatchXMLData	以 XML 字符串的形式从修补程序中提取信息。
FileHash	获取文件的路径，并返回该文件的 128 位哈希。
FileSignatureInfo	获取文件的路径并返回表示哈希或编码证书的字节的 SAFEARRAY。
FileSize	返回指定文件的大小。
FileVersion	返回指定路径的版本字符串或语言字符串。
ForceSourceListResolution	强制 Windows Installer 在下次需要源时在源列表中搜索有效的产品源。
InstallProduct	打开安装程序包并初始化安装会话。
LastErrorRecord	返回一个 Record 对象，该对象包含生成错误记录的函数中最新错误的错误参数。
OpenDatabase	打开现有数据库或创建新数据库。
OpenPackage	打开一个安装程序包，适用于可访问产品数据库和安装引擎的函数。
OpenProduct	使用产品代码打开已安装产品的安装程序包。
ProvideAssembly	返回程序集的已安装路径。
ProvideComponent	返回完整的组件路径并执行任何必要的安装。
ProvideQualifiedComponent	返回完整的组件路径并执行任何必要的安装。
RegistryValue	读取有关指定的值注册表项的信息。
ReinstallFeature	重新安装功能或纠正已安装功能的问题。
ReinstallProduct	重新安装产品或纠正已安装产品中的安装问题。
RemovePatches	针对有资格接收修补程序的产品，移除一个或多个修补程序。
UseFeature	递增特定功能的使用情况计数，并返回该功能的安装状态。

 

属性

Installer 对象具有以下属性。

属性	访问类型	说明
ClientsEx		返回一个 RecordList 对象，该对象列出使用指定已安装组件的产品。 Windows Installer 4.5 及更低版本：不支持。
ComponentClients		返回一个 StringList 对象，该对象枚举指定组件的客户端集。
ComponentPath		返回已安装组件的完整路径。
ComponentPathEx		返回一个 RecordList 对象，该对象提供指定已安装组件的完整路径。 Windows Installer 4.5 及更低版本：不支持。
ComponentQualifiers		返回一个 StringList 对象，该对象枚举指定组件的注册限定符集。
组件		返回一个 StringLis 对象，该对象枚举所有产品的已安装组件集。
ComponentsEx		返回一个 RecordList 对象，该对象列出了已安装的组件。 Windows Installer 4.5 及更低版本：不支持。
环境	读取/写入	当前进程的环境变量的字符串值。
FeatureParent		指定功能的父功能。
功能		返回一个 StringList 对象，该对象枚举指定产品的已发布功能集。
FeatureState		返回功能的安装状态。
FeatureUsageCount		返回已使用该功能的次数。
FeatureUsageDate		返回上次使用指定功能的日期。
FileAttributes		返回一个数字，表示文件或文件夹的指定路径的组合文件属性。
修补程序		返回一个 StringList 对象，该对象包含应用于产品的所有修补程序。
PatchesEx		枚举 Patch 对象的集合。
PatchFiles		返回一个 StringList 对象，该对象包含可通过提供的修补程序列表更新的文件列表。
PatchInfo		返回有关修补程序的信息。
PatchTransforms		返回包含在指定修补程序包中并且应用于指定产品的转换列表（以分号分隔）。
ProductElevated		如果产品是托管的，则返回 True；如果产品未托管，则返回 False。
ProductInfo		返回已安装或已发布产品的指定属性的值。
ProductInfoFromScript		返回存储在播发脚本中的指定属性的值。
产品		返回一个 StringList 对象，该对象枚举为当前用户和计算机安装或播发的所有产品的集合。
ProductsEx		枚举 Product 对象的集合。
ProductState		返回产品的安装状态信息。
QualifierDescription		返回描述限定组件的文本字符串。
RelatedProducts		返回一个 StringList 对象，该对象枚举为当前用户和计算机安装或公布的所有产品的集合，这些产品在其属性表中具有指定的 UpgradeCode 属性。
ShortcutTarget		检查快捷方式并返回其产品、功能名称和组件（如果可用）。
SummaryInformation		返回一个 SummaryInfo 对象，该对象可用于检查和更新属性以及将属性添加到包或转换的摘要信息流。
UILevel	读取/写入	指示在当前进程空间中打开和处理后续包时要使用的用户界面类型。
版本		返回当前版本的 Windows Installer 的字符串表示形式。

 

要求

要求	值
版本	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
DLL	Msi.dll
IID	IID_IInstaller 定义为 000C1090-0000-0000-C000-000000000046

另请参阅

使用自动化接口

Windows Installer 脚本编写示例