IEditionUpgradeHelper::UpdateOperatingSystem 方法 (editionupgradehelper.h)

将已安装的操作系统版本升级到用户在 Windows 应用商店中购买的版本,或获取操作系统的正版副本。

语法

HRESULT UpdateOperatingSystem(
  [in] LPCWSTR contentId
);

参数

[in] contentId

用户购买的操作系统版本以及方法应安装的内容标识符。

如果此版本是当前安装的 Windows 版本的更高版本,则此方法将执行升级到该版本,如果此版本与当前安装的版本相同,则此方法将安装该版本的正版副本。

返回值

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

此方法从当前安装的版本执行升级时,该方法执行以下步骤:

  • 将操作系统版本升级到用户从 Windows 应用商店购买的产品。
  • 显示通知用户升级进度的用户界面。
  • 升级完成后重新启动计算机。
  • 依赖于其他系统组件在计算机重启时检查许可证。
此方法安装操作系统的正版副本时,该方法执行以下步骤:
  • 检查在调用 UpdateOperatingSystem 之前从存储中下载的许可证。
  • 关闭任何对于当前版本的 Windows 来说不是正版的用户体验。

要求

要求
最低受支持的客户端 Windows 10 [仅限桌面应用]
最低受支持的服务器 Windows Server 2016 [仅限桌面应用]
目标平台 Windows
标头 editionupgradehelper.h

另请参阅

CanUpgrade

GetGenuineLocalStatus

GetOsProductContentId

IEditionUpgradeHelper