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 |
|
| IID |
IID_IInstaller 定义为 000C1090-0000-0000-C000-000000000046 |
另请参阅