VpnChannel.AddAndAssociateTransport(Object, Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Prépare, marque et crée le transport à utiliser par le framework VPN en tant que lien de transport qui communique le plug-in VPN au serveur VPN. Cet appel doit être effectué avant toute autre opération liée aux API du framework VPN.
public:
virtual void AddAndAssociateTransport(Platform::Object ^ transport, Platform::Object ^ context) = AddAndAssociateTransport;void AddAndAssociateTransport(IInspectable const& transport, IInspectable const& context);public void AddAndAssociateTransport(object transport, object context);function addAndAssociateTransport(transport, context)Public Sub AddAndAssociateTransport (transport As Object, context As Object)Paramètres
- transport
-
Object
Platform::Object
IInspectable
Objet IInspectable pour le transport de socket. Cet objet peut être un Windows.Networking.Sockets.StreamSocket ou un Windows.Networking.DatagramSocket. Ce socket contrôle la connexion au serveur VPN et sera utilisé pour envoyer des paquets IP encapsulés et recevoir des données encapsulées. Le socket doit être non connecté au point de l’appel.
- context
-
Object
Platform::Object
IInspectable
Objet de contexte de transport à utiliser, par exemple le nom d’un hôte ou d’un serveur.
Configuration requise pour Windows
| Famille d’appareils |
Windows 10, version 1803 (introduit dans 10.0.17134.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduit dans v6.0)
|
| Fonctionnalités de l’application |
networkingVpnProvider
|
Remarques
Si la fonction réussit, la valeur de retour est S_OK; sinon, la fonction retourne une valeur hresult d’erreur décrivant l’échec spécifique. Si le plug-in n’est pas connecté, l’erreur est E_ACCESSDENIED.
Note
Tout appel à cette API en dehors d’un plug-in VPN connecté échoue, car l’activité et les interactions entre le plug-in VPN et le système sont contrôlées par le profil VPN. L’appel échoue si l’infrastructure VPN ne prend pas en charge le type de transport spécifié implémenté par l’objet de transport. Le socket ne doit pas avoir été connecté au moment de cet appel. Sinon, l’appel échoue avec une erreur de paramètre non valide.