VpnChannel.AssociateTransport(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 et marque le transport à utiliser par l’infrastructure 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 AssociateTransport(Platform::Object ^ mainOuterTunnelTransport, Platform::Object ^ optionalOuterTunnelTransport) = AssociateTransport;void AssociateTransport(IInspectable const& mainOuterTunnelTransport, IInspectable const& optionalOuterTunnelTransport);public void AssociateTransport(object mainOuterTunnelTransport, object optionalOuterTunnelTransport);function associateTransport(mainOuterTunnelTransport, optionalOuterTunnelTransport)Public Sub AssociateTransport (mainOuterTunnelTransport As Object, optionalOuterTunnelTransport As Object)Paramètres
- mainOuterTunnelTransport
-
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.
- optionalOuterTunnelTransport
-
Object
Platform::Object
IInspectable
Objet IInspectable facultatif 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.
Configuration requise pour Windows
| 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 outerTunnelTransport. 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.
À partir de cette méthode, un plug-in peut choisir entre les combinaisons suivantes de sockets :
- Un socket TCP (StreamSocket),
- Un socket UDP (DatagramSocket),
- Deux sockets TCP, ou
- Deux sockets, un TCP et un UDP.