AppListEntry.LaunchForUserAsync(User) Método

Definição

Namespace:

Windows.ApplicationModel.Core

Inicie o aplicativo associado a este AppListEntry dentro do contexto de um usuário especificado.

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)

Parâmetros

user

User

O contexto do usuário no qual o aplicativo deve ser iniciado.

Retornos

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Retornará true se o lançamento for bem-sucedido; caso contrário, false.

Atributos

RemoteAsyncAttribute

Requisitos do Windows

Família de dispositivos	Windows 10, version 1803 (introduzida na 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v6.0)

Exemplos

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

Comentários

Essa é uma API MUA (Multi-User-Aware) e só pode ser usada por aplicativos que se declaram MUA e apenas em dispositivos que dão suporte a aplicativos MUA. O aplicativo é iniciado da mesma forma que se o usuário especificado clicasse na entrada na lista de aplicativos. O usuário é passado para o aplicativo iniciado por meio dos argumentos do evento. Passar null para user resultará em uma exceção.

Os aplicativos MUA são iniciados com o contexto de usuário padrão. O user valor , que é passado para o aplicativo ativado por meio dos argumentos de evento, indica de quem o aplicativo está ativando em nome de. Um aplicativo com reconhecimento de usuário único será iniciado no contexto do user valor que é passado para essa API.

Confira também

• Introdução aos aplicativos multiusuário