UninstallApplication 函数 (appmgmt.h)

  • 项目

UninstallApplication 函数卸载使用 Windows Installer .msi 文件来处理安装和安装的组策略应用程序。 仅应在用户组策略应用程序之前通过调用 MsiConfigureProduct 函数尝试卸载的用户上下文中调用 UninstallApplication 函数。 InstallApplication 函数可以安装组策略应用程序。

注意 未能调用 UninstallApplication 作为卸载基于组策略的应用程序的协议的一部分，可能会导致 策略 (RSoP 的结果集) 指示不准确的信息。
 

语法

DWORD UninstallApplication(
  [in] LPWSTR ProductCode,
  [in] DWORD  dwStatus
);

参数

[in] ProductCode

要卸载的产品的 Windows Installer 产品代码。 应用程序的 产品代码 应以 Windows Installer GUID 的形式作为带大括号的字符串提供。

[in] dwStatus

卸载尝试的状态。 dwStatus 参数是 MsiConfigureProduct 返回的卸载尝试的 Windows 成功代码。 系统可以使用此功能来确保 策略的结果集 (RSoP) 指示卸载是失败还是成功。

返回值

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

注解

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

通过调用特定于安装应用程序的 uninstall 函数或命令，删除使用软件安装设置 (.zap 文件) 安装的应用程序。 有关使用 Windows 安装程序 以外的安装应用程序的信息，请参阅 Microsoft 知识库中的文章231747“如何使用 .zap 文件发布非 MSI 程序”。

要求

要求 值
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 appmgmt.h
Library Advapi32.lib
DLL Advapi32.dll

另请参阅

组策略函数

组策略概述

InstallApplication

MsiConfigureProduct