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