InstallApplication 函数 (appmgmt.h)

项目
03/04/2024

InstallApplication 函数可以安装已部署到属于域的目标用户的应用程序。调用 InstallApplication 的用户的安全上下文必须是登录到域中信任目标用户的域的计算机的域用户的安全上下文。当目标用户登录时，必须成功应用组策略。

语法

DWORD InstallApplication(
  [in] PINSTALLDATA pInstallInfo
);

参数

[in] pInstallInfo

指向 INSTALLDATA 结构的指针，该结构指定要安装的应用程序。

返回值

如果函数成功，则返回值 ERROR_SUCCESS。否则，函数将返回系统错误代码之一。有关错误代码的完整列表，请参阅系统错误代码或头文件 WinError.h。

注解

InstallApplication 函数只能安装使用组策略部署的应用程序。域管理员可以使用组策略对象 (GPO) 的用户配置部分将应用程序部署到目标用户。目标用户必须属于目标域，GPO 必须应用于目标域中的此用户。 InstallApplication 函数根据标准组策略继承规则安装应用程序。如果同一应用程序部署在多个 GPO 中，则函数将安装部署在最高优先级 GPO 中的应用程序版本。为用户安装应用程序后，计算机上的其他用户看不到该应用程序。这是通过用户组策略部署的应用程序的标准。

InstallApplication 函数可以安装部署的应用程序，这些应用程序使用 Windows Installer (.msi 文件) 或软件安装设置 (.zap 文件) 来处理安装和安装。

InstallApplication 函数可以安装使用 Windows Installer 包进行安装的应用程序。在这种情况下，调用 InstallApplication 的用户不需要具有管理员权限。系统可以安装应用程序，因为 Windows Installer 是域管理员部署的受信任应用程序。接收应用程序的用户必须有权访问 .msi 文件的位置。

通过调用 Windows Installer 函数 MsiConfigureProduct 来卸载应用程序，删除使用 .msi 文件安装的应用程序。然后调用 UninstallApplication，通过组策略通知系统不再在客户端上管理该应用程序。即使卸载失败，也应调用 UninstallApplication，因为这会使系统保持策略的结果集 (RSoP) 准确。

InstallApplication 函数还可以根据软件安装设置安装应用程序 (.zap 文件) 安装应用程序。接收应用程序的用户必须有权访问 .zap 文件的位置。 .zap 文件是类似于 .ini 文件的文本文件，它使 Windows 能够发布应用程序 (例如，Setup.exe) 使用 添加或删除程序进行安装。若要发布不使用 Windows Installer 的应用程序，必须创建 .zap 文件，将 .zap 文件复制到软件分发点服务器，然后使用基于组策略的软件部署为用户发布应用程序。如果使用 .zap 文件部署应用程序，则安装该应用程序的用户必须在计算机上安装软件的权限。不能对分配的应用程序使用 .zap 文件。

通过使用软件安装设置 (.zap 文件) ，通过调用卸载函数或特定于安装应用程序的命令删除应用程序。

有关使用 Windows 安装程序以外的安装应用程序的信息，请参阅 Microsoft 知识库中的文章231747“如何使用 .zap 文件发布非 MSI 程序”。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	appmgmt.h
Library	Advapi32.lib
DLL	Advapi32.dll
API 集	在 Windows 8) 中引入的 ext-ms-win-advapi32-msi-l1-1-0 (