Windows.Management.Update 命名空间

此命名空间中的类型允许用户选择在其设备上接收Windows Insider Preview生成。 这些 API 旨在供 IoT 原始设备制造商 (OEM) 使用。

类

PreviewBuildsManager	管理设备的预览版本状态。
PreviewBuildsState	包含用于连接设备以将设备与 Windows 预览体验计划关联的信息。
WindowsUpdate	WindowsUpdate 本质上是一个属性包，其中包含有关挂起或正在进行的更新的信息。
WindowsUpdateActionCompletedEventArgs	相应 WindowsUpdateManager.ActionCompleted 事件的事件数据。
WindowsUpdateActionProgress	由 WindowsUpdate 和WindowsUpdateProgressChangedEventArgs 的 ActionProgress 属性返回。
WindowsUpdateActionResult	由 WindowsUpdate.ActionResult 属性返回。
WindowsUpdateAdministrator	启用在设备上管理 Windows 汇报。
WindowsUpdateApprovalData	允许在通过 ApprovWindowsUpdate 批准更新时配置其他元数据。
WindowsUpdateAttentionRequiredInfo	表示 WindowsUpdateAttentionRequiredReason 和时间戳的元组。
WindowsUpdateAttentionRequiredReasonChangedEventArgs	相应 WindowsUpdateManager.AttentionRequiredReasonChanged 事件的事件数据。
WindowsUpdateGetAdministratorResult	表示调用 GetRegisteredAdministrator 的结果。
WindowsUpdateItem	表示有关以前完成的更新的信息的属性包。
WindowsUpdateManager	用于通过回调监视更新活动和检索更新历史记录的接口。
WindowsUpdateProgressChangedEventArgs	相应 WindowsUpdateManager.ProgressChanged 事件的事件数据。
WindowsUpdateRestartRequestOptions	表示可以配置并传递到 RequestRestart 的字段的属性包。
WindowsUpdateScanCompletedEventArgs	相应 WindowsUpdateManager.ScanCompleted 事件的事件数据。

枚举

WindowsUpdateAdministratorOptions	定义常量，这些常量指定调用方在注册 RegisterForAdministration 时希望控制的管理员选项。
WindowsUpdateAdministratorStatus	定义指定状态代码以指示 Windows 更新管理员注册/注销是否成功的常量。
WindowsUpdateAttentionRequiredReason	定义常量，这些常量指定更新在继续之前需要注意的详细原因。

示例

此 C# 示例演示了用户如何确定其设备是否正在接收预览版，或者是否存在阻止设备获取预览版的问题。

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; 
} 

注解

这些 API 允许 IoT 设备接收Windows Insider Preview生成。 预计设备的 OEM 会在 Windows 设备门户中 创建设备配置属性的设置页。 在高级别，设备将读取 来自 PreviewBuildsState 的信息，然后显示给用户，然后使用它向设备注册用户帐户。 注册后，所有设置管理都将通过 Windows 预览体验计划联机完成，而不是在设备本身上完成。