SystemSetupInfo 클래스

정의

네임스페이스:

Windows.System.Profile

OOBE(Out-of-Box Experience)의 수명 주기에서 현재 단계를 설명하는 속성 및 이벤트를 제공합니다.

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

상속

Object Platform::Object IInspectable SystemSetupInfo

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10, version 1809 (10.0.17763.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v7.0에서 도입되었습니다.)

예제

UWP(유니버설 Windows 플랫폼) 앱은 OOBE 중에 특수한 동작(예: UI(사용자 인터페이스)에 설정된 범위가 지정된 기능 또는 OOBE가 완료된 후에만 시작되는 백그라운드 작업이 있으므로 OOBE가 완료되었는지 여부를 알아야 합니다. OEM으로 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);
}

OEM은 공장 현장 테스트 중에 디바이스가 OOBE로 성공적으로 부팅된다는 것을 알고 싶습니다. 모든 디바이스가 제조 프로세스의 최종 확인 단계로 이 테스트를 통과하기를 원하므로 자동화 중에 OOBE가 진행 중이고 준비가 되면 알림을 받습니다.

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

설명

OOBE(Out-of-Box Experience)는 사용자가 Windows 10 디바이스를 처음 켭니다. OOBE는 EULA를 수락하고 시스템 기본 로캘을 설정하며 초기 사용자 계정을 설정하는 데 도움이 됩니다.

속성

OutOfBoxExperienceState

OOBE(Out-of-Box Experience)의 수명 주기에서 현재 단계를 나타내는 값을 가져옵니다.

이벤트

OutOfBoxExperienceStateChanged

OOBE(Out-of-Box Experience)의 수명 주기에서 현재 단계가 변경될 때 발생합니다.