AppListEntry.LaunchForUserAsync(User) メソッド

リファレンス

定義

名前空間:: Windows.ApplicationModel.Core

重要

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

編集

指定したユーザーのコンテキスト内で、この AppListEntry に関連付けられているアプリを起動します。

public:
 virtual IAsyncOperation<bool> ^ LaunchForUserAsync(User ^ user) = LaunchForUserAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<bool> LaunchForUserAsync(User const& user);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<bool> LaunchForUserAsync(User user);

function launchForUserAsync(user)

Public Function LaunchForUserAsync (user As User) As IAsyncOperation(Of Boolean)

パラメーター

user: User

アプリを起動する必要があるユーザーコンテキスト。

戻り値

IAsyncOperation<Boolean>

IAsyncOperation<bool>

起動が成功した場合は true を返します。それ以外の場合は false。

属性: RemoteAsyncAttribute

Windows の要件

デバイスファミリ	Windows 10, version 1803 (10.0.17134.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v6.0 で導入)

例

public async void LaunchButton_Click(object sender, Windows.UI.Xaml.RoutedEventArgs e)
{
    // The active User is retrieved from the initial activation args and validated against list of active users
    User user = this.GetAppActiveUser();
    PackageManager pm = new PackageManager();
    // The App Family Name is stored as part of the Product Display Page
    Package p = pm.FindPackage(this.GetFocusedAppFamilyName());
    IReadOnlyList<AppListEntry> entries = await p.GetAppListEntriesAsync();

    //This assumes the first app in the package should be launched, if there is one in the package
    if (entries.Count > 0)
    {
        await entries[0].LaunchForUserAsync(user);
    }
}

注釈

これはマルチユーザー対応 (MUA) API であり、MUA であることを宣言するアプリでのみ使用でき、MUA アプリをサポートするデバイスでのみ使用できます。アプリは、指定したユーザーがアプリ一覧のエントリをクリックした場合と同じ方法で起動されます。ユーザーは、イベント引数を使用して起動されたアプリに渡されます。をuser渡nullすと、例外が発生します。

MUA アプリは、既定のユーザーコンテキストで起動します。イベント引数を使用してアクティブ化されたアプリケーションに渡される値は user 、アプリが代理でアクティブ化されているユーザーを示します。シングルユーザー対応アプリは、この API に渡される値の user コンテキストで起動します。

適用対象

こちらもご覧ください

マルチユーザーアプリケーションの概要