Partager via


VpnChannel.ActivateForeground(String, ValueSet) Méthode

Définition

Active l’application VPN au premier plan. Il est souvent utilisé pour permettre à l’utilisateur d’entrer des informations d’identification. Vous pouvez appeler ActivateForeground uniquement à partir de votre implémentation de IVpnPlugin.Connect. Pendant que l’application est au premier plan, le délai d’attente normal Connect est suspendu.

L’appel ActivateForeground sera annulé s’il y a une longue pause (environ 10 minutes). Si vous ne parvenez pas à lancer, le plug-in doit idéalement prendre en charge une méthode d’authentification qui n’a pas besoin de l’interface utilisateur (UI).

Destiné à prendre en charge les schémas d’authentification web tels que l’authentification SAML (Security Assertion Markup Language) et l’authentification Azure Active Directory (AAD).

public:
 virtual ValueSet ^ ActivateForeground(Platform::String ^ packageRelativeAppId, ValueSet ^ sharedContext) = ActivateForeground;
ValueSet ActivateForeground(winrt::hstring const& packageRelativeAppId, ValueSet const& sharedContext);
public ValueSet ActivateForeground(string packageRelativeAppId, ValueSet sharedContext);
function activateForeground(packageRelativeAppId, sharedContext)
Public Function ActivateForeground (packageRelativeAppId As String, sharedContext As ValueSet) As ValueSet

Paramètres

packageRelativeAppId
String

Platform::String

winrt::hstring

Chaîne contenant l’identificateur d’application relatif au package (PRAID) de l’application de premier plan à lancer.

sharedContext
ValueSet

Objet valueSet utilisé pour transmettre des informations à l’application de premier plan. L’application de premier plan peut y accéder à partir des arguments d’événement d’activation.

Retours

ValeurSet objet contenant un objet Windows Runtime de votre choix passé de l’application de premier plan au plug-in VPN, indiquant le résultat de la demande de premier plan.

Configuration requise pour Windows

Famille d’appareils
Windows 11 (introduit dans 10.0.22000.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v14.0)
Fonctionnalités de l’application
networkingVpnProvider

Remarques

Note

L’appel de cette API en dehors de l’implémentation de méthode IVpnPlugin.Connect dans un plug-in VPN échoue.

L’utilisation du mécanisme d’activation au premier plan nécessite la gestion de l’activation à plusieurs endroits.

Dans votre méthode IVpnPlugin.Connect, vous allez appeler ActivateForeground avec l’identificateur d’application relatif au package approprié (PRAID) et un ValueSet qui contient toutes les valeurs que vous souhaitez envoyer à votre application de premier plan.

Dans l’application de premier plan, vous devez intercepter l’activation. L’application de premier plan est activée avec une valeur Windows.ApplicationModel.ActivationKind de vpnforeground. Les arguments d’activation seront de type Windows.Networking.Vpn.VpnForegroundActivatedEventArgs, et inclura trois champs.

  1. ProfileName (string).
  2. SharedContext (ValueSet).
  3. ActivationOperation (Windows.Networking.Vpn.VpnForegroundActivationOperation.

L’application de premier plan peut ensuite configurer l’interface utilisateur de votre application pour gérer l’autorisation nécessaire (ou les données nécessaires). Lorsque vous avez terminé, vous devez appeler la méthode Complete de l'ActivationOperation , en passant un ValueSet de valeurs à retourner à l’appel IVpnPlugin.Connect.

De retour dans l’appel IVpnPlugin.Connect, utilisez l' ValueSet retourné par ActivateForeground pour déterminer si l’authentification a réussi et gérer les erreurs.

S’applique à