Condividi tramite


VpnChannel.AssociateTransport(Object, Object) Metodo

Definizione

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

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:

Si applica a