Поделиться через


AppListEntry.LaunchForUserAsync(User) Метод

Определение

Запустите приложение, связанное с этим Элементом 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

Контекст пользователя, в который должно быть запущено приложение.

Возвращаемое значение

Возвращает значение true , если запуск выполнен успешно; в противном случае — false.

Атрибуты

Требования к 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);
    }
}

Комментарии

Это API с поддержкой нескольких пользователей (MUA) и может использоваться только приложениями, которые объявляют себя MUA, и только на устройствах, поддерживающих приложения MUA. Приложение запускается так же, как если бы указанный пользователь щелкнул запись в списке приложений. Пользователь передается в запущенное приложение через аргументы событий. Передача null для user приведет к возникновению исключения.

Приложения MUA запускаются с контекстом пользователя по умолчанию. Значение user , которое передается в активированное приложение через аргументы события, указывает, от имени кого активируется приложение. Приложение с поддержкой одного пользователя запустится в контексте user значения, передаваемого в этот API.

Применяется к

См. также раздел