VpnChannel.AddAndAssociateTransport(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

Vorbereitet, markiert und erstellt den Transport für die Verwendung durch das VPN-Framework 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 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)

Parameter

transport: 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.

context: Object
Platform::Object

IInspectable

Das zu verwendende Transportkontextobjekt, z. B. den Namen eines Hosts oder Servers.

Windows-Anforderungen

Gerätefamilie	Windows 10, version 1803 (eingeführt in 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v6.0)
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 Transport--Objekt implementiert wird. Der Socket darf zum Zeitpunkt dieses Aufrufs nicht verbunden sein, andernfalls schlägt der Aufruf mit einem ungültigen Parameterfehler fehl.

Gilt für:

Freigeben über