SystemSetupInfo クラス

リファレンス

定義

名前空間:: Windows.System.Profile

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

Out-of-Box Experience (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

継承: Object Platform::Object IInspectable SystemSetupInfo

属性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイスファミリ	Windows 10, version 1809 (10.0.17763.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v7.0 で導入)

例

ユニバーサル Windows プラットフォーム (UWP) アプリは、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;
 }

注釈

Out-of-Box Experience (OOBE) は、ユーザーが初めて Windows 10 デバイスをオンにした場合に発生するフローです。 OOBE は EULA の同意を取得し、システムの既定のロケールを設定し、初期ユーザーアカウントの設定に役立ちます。

プロパティ

OutOfBoxExperienceState

Out-of-Box Experience (OOBE) のライフサイクルにおける現在のステージを表す値を取得します。

イベント

OutOfBoxExperienceStateChanged

Out-of-Box Experience (OOBE) のライフサイクルの現在のステージが変更されたときに発生します。

適用対象