VpnChannel.ReplaceAndAssociateTransport(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.
Remplace un transport existant par un nouveau transport utilisé par l’infrastructure VPN en tant que lien de transport qui communique le plug-in VPN au serveur VPN.
public:
virtual void ReplaceAndAssociateTransport(Platform::Object ^ transport, Platform::Object ^ context) = ReplaceAndAssociateTransport;void ReplaceAndAssociateTransport(IInspectable const& transport, IInspectable const& context);public void ReplaceAndAssociateTransport(object transport, object context);function replaceAndAssociateTransport(transport, context)Public Sub ReplaceAndAssociateTransport (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.