Metode IEditionUpgradeHelper::UpdateOperatingSystem (editionupgradehelper.h)

Meningkatkan edisi sistem operasi yang diinstal ke edisi yang dibeli pengguna di Bursa Windows, atau mendapatkan salinan asli sistem operasi.

Sintaks

HRESULT UpdateOperatingSystem(
  [in] LPCWSTR contentId
);

Parameter

[in] contentId

Pengidentifikasi konten edisi sistem operasi yang dibeli pengguna dan metode mana yang harus diinstal.

Jika edisi ini adalah edisi yang lebih tinggi dengan edisi Windows yang saat ini diinstal, metode ini melakukan peningkatan ke edisi tersebut, Jika edisi ini adalah edisi yang sama dengan edisi yang saat ini diinstal, metode ini menginstal salinan asli edisi tersebut.

Nilai kembali

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Ketika metode ini melakukan peningkatan dari edisi yang saat ini diinstal, metode mengambil langkah-langkah berikut:

• Meningkatkan edisi sistem operasi ke produk yang dibeli pengguna dari Bursa Windows.
• Menampilkan antarmuka pengguna yang memberi tahu pengguna tentang kemajuan peningkatan.
• Menghidupkan ulang komputer ketika pemutakhiran selesai.
• Bergantung pada komponen sistem lain untuk memeriksa lisensi ketika komputer dimulai ulang.

Ketika metode ini menginstal salinan asli sistem operasi, metode ini mengambil langkah-langkah berikut:

• Memeriksa lisensi yang diunduh dari penyimpanan sebelum UpdateOperatingSystem dipanggil.
• Mematikan pengalaman pengguna yang tidak asli untuk edisi Windows saat ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2016 [hanya aplikasi desktop]
Target Platform	Windows
Header	editionupgradehelper.h

Lihat juga

CanUpgrade

GetGenuineLocalStatus

GetOsProductContentId

IEditionUpgradeHelper