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.
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по