VpnChannel.AssociateTransport(Object, Object) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Prepara e contrassegna il trasporto per l'uso da parte del framework VPN come collegamento di trasporto che comunica il plug-in VPN al server VPN. Questa chiamata deve essere eseguita prima di qualsiasi altra operazione correlata alle API del 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)
Parametri
- mainOuterTunnelTransport
-
Object
Platform::Object
IInspectable
Oggetto IInspectable per il trasporto socket. Questo oggetto può essere un Windows.Networking.Sockets.StreamSocket o un Windows.Networking.DatagramSocket. Questo socket controlla la connessione al server VPN e verrà usato per inviare pacchetti IP incapsulati e ricevere dati incapsulati. Il socket deve essere scollegato al punto della chiamata.
- optionalOuterTunnelTransport
-
Object
Platform::Object
IInspectable
Oggetto facoltativo
Requisiti Windows
Funzionalità dell'app |
networkingVpnProvider
|
Commenti
Se la funzione ha esito positivo, il valore restituito è S_OK, in caso contrario la funzione restituirà un valore hresult di errore che descrive l'errore specifico. Se il plug-in non è connesso, l'errore verrà E_ACCESSDENIED.
Nota
Qualsiasi chiamata a questa API all'esterno di un plug-in VPN connesso avrà esito negativo, perché l'attività e le interazioni tra il plug-in VPN e il sistema sono controllati dal profilo VPN. La chiamata avrà esito negativo se il framework VPN non supporta il tipo di trasporto specificato implementato dall'oggetto outerTunnelTransport. Il socket non deve essere stato connesso al momento della chiamata. In caso contrario, la chiamata avrà esito negativo con un errore di parametro non valido.
Da questo metodo, un plug-in può scegliere tra le combinazioni seguenti di socket:
- Un socket TCP (StreamSocket),
- Un socket UDP (DatagramSocket),
- Due socket TCP o
- Due socket, uno TCP e un UDP.