SystemSetupInfo Clase

Definición

Espacio de nombres:

Windows.System.Profile

Proporciona una propiedad y un evento que describen la fase actual en el ciclo de vida de la experiencia rápida (OOBE).

public ref class SystemSetupInfo abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 458752)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SystemSetupInfo final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 458752)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class SystemSetupInfo

Public Class SystemSetupInfo

Herencia

Object Platform::Object IInspectable SystemSetupInfo

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10, version 1809 (se introdujo en la versión 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v7.0)

Ejemplos

Una aplicación de Plataforma universal de Windows (UWP) debe saber si la OOBE está completa, ya que tiene un comportamiento especial durante la OOBE (por ejemplo, un conjunto de características con ámbito en la interfaz de usuario o tareas en segundo plano que solo se inician una vez completada la OOBE). Como OEM, esta podría ser la aplicación que se ejecuta durante la OOBE.

private bool ShouldUseSimpleUserInterface()
{
    var oobeState = Windows.System.Profile.SystemSetupInfo.OutOfBoxExperienceState;

    // When this UWP is shown before OOBE is complete, use a simplified UI
    // with limited options, which matches the style of the rest of OOBE.
    return (oobeState != SystemOutOfBoxExperienceState.Completed);
}

Como OEM, quiere saber que un dispositivo arranca correctamente en OOBE durante las pruebas de fábrica. Quiere que todos los dispositivos realicen esta prueba como paso de comprobación final en el proceso de fabricación y, por lo tanto, durante la automatización, se le notificará cuando OOBE esté en curso y listo.

// Task that has its result set once OOBE is in progress.
private TaskCompletionSource<object> oobeInProgress;

// Called when OOBE state changes. Guaranteed to be called at least once, at
// the time of event registration.
private void OnOobeStateChanged(object sender, object e)
{
    var oobeState = Windows.System.Profile.SystemSetupInfo.OutOfBoxExperienceState;
    if (oobeState == SystemOutOfBoxExperienceState.InProgress)
    {
        oobeInProgress.TrySetResult(null);
    } 
}

private async void WaitForOobeStartedAsync()
{
    oobeInProgress = new TaskCompletionSource<object>();
    Windows.System.Profile.SystemSetupInfo.OutOfBoxExperienceStateChanged += OnOobeStateChanged;
    await oobeInProgress.Task; // NOTE: you could add a timeout here, and fail when hit.
    Windows.System.Profile.SystemSetupInfo.OutOfBoxExperienceStateChanged -= OnOobeStateChanged;
 }

Comentarios

La experiencia rápida (OOBE) es el flujo que se produce la primera vez que el usuario activa un dispositivo Windows 10. La OOBE obtiene la aceptación del CLUF, establece la configuración regional predeterminada del sistema y ayuda a configurar la cuenta de usuario inicial.

Propiedades

OutOfBoxExperienceState

Obtiene un valor que representa la fase actual del ciclo de vida de la experiencia integrada (OOBE).

Eventos

OutOfBoxExperienceStateChanged

Se genera cuando cambia la fase actual del ciclo de vida de la experiencia rápida (OOBE).