VpnChannel.AssociateTransport(Object, Object) Methode

Referenz

Definition

Namespace:: Windows.Networking.Vpn

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Bereitet den Transport für die Verwendung durch das VPN-Framework als Transportverbindung vor und kennzeichnet ihn als Transportverbindung, die das VPN-Plug-In an den VPN-Server kommuniziert. Dieser Aufruf muss vor allen anderen Vorgängen im Zusammenhang mit den VPN-Framework-APIs ausgeführt werden.

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)

Parameter

mainOuterTunnelTransport: Object
Platform::Object

IInspectable

Ein IInspectable-Objekt für den Sockettransport. Dieses Objekt kann ein Windows.Networking.Sockets.StreamSocket oder ein Windows.Networking.DatagramSocketsein. Dieser Socket steuert die Verbindung mit dem VPN-Server und wird verwendet, um gekapselte IP-Pakete zu senden und gekapselte Daten zu empfangen. Der Socket muss an der Stelle des Anrufs nicht verbunden sein.

optionalOuterTunnelTransport: Object
Platform::Object

IInspectable

Ein optionales IInspectable-Objekt für den Sockettransport. Dieses Objekt kann ein Windows.Networking.Sockets.StreamSocket oder ein Windows.Networking.DatagramSocketsein. Dieser Socket steuert die Verbindung mit dem VPN-Server und wird verwendet, um gekapselte IP-Pakete zu senden und gekapselte Daten zu empfangen.

Windows-Anforderungen

App-Funktionen

networkingVpnProvider

Hinweise

Wenn die Funktion erfolgreich ist, wird der Rückgabewert S_OK, andernfalls gibt die Funktion einen Fehler-Hresult-Wert zurück, der den spezifischen Fehler beschreibt. Wenn das Plug-In nicht verbunden ist, wird der Fehler E_ACCESSDENIED.

Anmerkung

Jeder Aufruf dieser API außerhalb eines verbundenen VPN-Plug-Ins schlägt fehl, da Aktivitäten und Interaktionen zwischen dem VPN-Plug-In und dem System vom VPN-Profil gesteuert werden. Der Aufruf schlägt fehl, wenn das VPN-Framework nicht den angegebenen Transporttyp unterstützt, der vom outerTunnelTransport-Objekt implementiert wird. Der Socket darf zum Zeitpunkt dieses Aufrufs nicht verbunden sein, andernfalls schlägt der Aufruf mit einem ungültigen Parameterfehler fehl.

Bei dieser Methode kann ein Plug-In zwischen den folgenden Kombinationen von Sockets wählen:

Ein TCP-Socket (StreamSocket),
Ein UDP-Socket (DatagramSocket),
Zwei TCP-Sockets oder
Zwei Sockets, ein TCP und ein UDP.

Gilt für:

Freigeben über