Windows.Management.Update Namespace

Die Typen in diesem Namespace ermöglichen es Benutzern, den Empfang von Windows Insider Preview-Builds auf ihrem Gerät zu deaktivieren oder zu deaktivieren. Die APIs sind für die Verwendung von IoT-Erstausrüstungsherstellern (OEMs) vorgesehen.

Klassen

PreviewBuildsManager

Verwaltet den Status der Vorschaubuilds für das Gerät.

PreviewBuildsState

Enthält Informationen, die zum Verbinden eines Geräts verwendet werden, um das Gerät dem Windows-Insider-Programm zuzuordnen.

WindowsUpdate

WindowsUpdate ist im Wesentlichen ein Eigenschaftenbehälter mit Informationen zu einem ausstehenden oder laufenden Update.

WindowsUpdateActionCompletedEventArgs

Ereignisdaten für das entsprechende WindowsUpdateManager.ActionCompleted-Ereignis .

WindowsUpdateActionProgress

Wird von den Eigenschaften ActionProgress von WindowsUpdate und WindowsUpdateProgressChangedEventArgs zurückgegeben.

WindowsUpdateActionResult

Wird von der WindowsUpdate.ActionResult-Eigenschaft zurückgegeben.

WindowsUpdateAdministrator

Ermöglicht die Verwaltung von Windows-Updates auf einem Gerät.

WindowsUpdateApprovalData

Ermöglicht das Konfigurieren zusätzlicher Metadaten für ein Update, wenn es über ApproveWindowsUpdate genehmigt wird.

WindowsUpdateAttentionRequiredInfo

Stellt ein Tupel aus einem WindowsUpdateAttentionRequiredReason und einem Zeitstempel dar.

WindowsUpdateAttentionRequiredReasonChangedEventArgs

Ereignisdaten für das entsprechende WindowsUpdateManager.AttentionRequiredReasonChanged-Ereignis .

WindowsUpdateGetAdministratorResult

Stellt das Ergebnis des Aufrufs von GetRegisteredAdministrator dar.

WindowsUpdateItem

Stellt einen Eigenschaftenbehälter mit Informationen zu einem zuvor abgeschlossenen Update dar.

WindowsUpdateManager

Schnittstelle, die für die Überwachung der Updateaktivität über Rückrufe und das Abrufen des Updateverlaufs verwendet wird.

WindowsUpdateProgressChangedEventArgs

Ereignisdaten für das entsprechende WindowsUpdateManager.ProgressChanged-Ereignis .

WindowsUpdateRestartRequestOptions

Stellt einen Eigenschaftenbehälter mit Feldern dar, die konfiguriert und dann an RequestRestart übergeben werden können.

WindowsUpdateScanCompletedEventArgs

Ereignisdaten für das entsprechende WindowsUpdateManager.ScanCompleted-Ereignis .

Enumerationen

WindowsUpdateAdministratorOptions

Definiert Konstanten, die die Administratoroptionen angeben, die der Aufrufer bei der Registrierung bei RegisterForAdministration steuern möchte.

WindowsUpdateAdministratorStatus

Definiert Konstanten, die status Codes angeben, um anzugeben, ob die Registrierung/Aufhebung der Registrierung eines Windows Update-Administrators erfolgreich war.

WindowsUpdateAttentionRequiredReason

Definiert Konstanten, die einen detaillierten Grund angeben, warum für ein Update Aufmerksamkeit erforderlich ist, bevor es fortgesetzt werden kann.

Beispiele

In diesem C#-Beispiel wird veranschaulicht, wie ein Benutzer feststellen kann, ob sein Gerät Vorschaubuilds empfängt oder ob Probleme auftreten, die das Gerät daran hindern, Vorschaubuilds zu erhalten.

public string GetErrorMessage() 
{ 
    PreviewBuildsManager manager = PreviewBuildsManager.GetDefault(); 
    if (manager != null) 
    { 
        PreviewBuildsState state = manager.GetCurrentState(); 
        if (state.Properties.ContainsKey("ErrorMessage")) 
        { 
            return state.Properties["ErrorMessage"].ToString(); 
        } 
    } 
    return String.Empty; 
} 

Hinweise

Diese APIs ermöglichen es einem IoT-Gerät, Windows Insider Preview Builds zu empfangen. Es wird erwartet, dass der OEM des Geräts im Windows-Geräteportal eine Einstellungsseite für Gerätekonfigurationseigenschaften erstellt. Auf allgemeiner Ebene werden Informationen aus PreviewBuildsState vom Gerät gelesen, dann dem Benutzer angezeigt und dann zum Registrieren des Benutzerkontos auf dem Gerät verwendet. Nach der Registrierung erfolgt die gesamte Einstellungsverwaltung online über das Windows-Insider-Programm und nicht auf dem Gerät selbst.