IEditionUpgradeHelper::UpdateOperatingSystem-Methode (editionupgradehelper.h)
Aktualisiert die installierte Edition des Betriebssystems auf die Edition, die der Benutzer im Windows Store erworben hat, oder ruft eine Originalkopie des Betriebssystems ab.
Syntax
HRESULT UpdateOperatingSystem(
[in] LPCWSTR contentId
);
Parameter
[in] contentId
Der Inhaltsbezeichner der Edition des Betriebssystems, das der Benutzer erworben hat und das die Methode installieren soll.
Wenn es sich bei dieser Edition um eine höhere Edition handelt als die aktuell installierte Edition von Windows, führt diese Methode ein Upgrade auf diese Edition durch. Wenn diese Edition dieselbe Edition wie die aktuell installierte Edition ist, wird mit dieser Methode eine Originalkopie dieser Edition installiert.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Wenn diese Methode ein Upgrade von der derzeit installierten Edition durchführt, führt die Methode die folgenden Schritte aus:
- Aktualisiert die Edition des Betriebssystems auf das Produkt, das der Benutzer im Windows Store erworben hat.
- Zeigt eine Benutzeroberfläche an, die den Benutzer über den Status des Upgrades informiert.
- Startet den Computer neu, wenn das Upgrade abgeschlossen ist.
- Basiert auf anderen Systemkomponenten, um die Lizenz beim Neustart des Computers zu überprüfen.
- Überprüft die Lizenz, die aus dem Speicher heruntergeladen wurde, bevor UpdateOperatingSystem aufgerufen wurde.
- Deaktiviert alle Benutzeroberflächen, die für die aktuelle Edition von Windows nicht original sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | editionupgradehelper.h |