VpnChannel.AssociateTransport(Object, Object) Método

Definición

Espacio de nombres:

Windows.Networking.Vpn

Prepara y marca el transporte para que lo use el marco vpn como un vínculo de transporte que comunica el complemento VPN al servidor VPN. Esta llamada debe realizarse antes de cualquier otra operación relacionada con las API del marco de 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)

Parámetros

mainOuterTunnelTransport

Object

Platform::Object

IInspectable

Objeto IInspectable para el transporte de sockets. Este objeto puede ser Windows.Networking.Sockets.StreamSocket o Windows.Networking.DatagramSocket. Este socket controlará la conexión al servidor VPN y se usará para enviar paquetes IP encapsulados y recibir datos encapsulados. El socket debe estar desconectado en el punto de la llamada.

optionalOuterTunnelTransport

Object

Platform::Object

IInspectable

Objeto IInspectable opcional para el transporte de sockets. Este objeto puede ser Windows.Networking.Sockets.StreamSocket o Windows.Networking.DatagramSocket. Este socket controlará la conexión al servidor VPN y se usará para enviar paquetes IP encapsulados y recibir datos encapsulados.

Requisitos de Windows

Características de aplicaciones

networkingVpnProvider

Comentarios

Si la función se ejecuta correctamente, el valor devuelto es S_OK; de lo contrario, la función devolverá un valor hresult de error que describe el error específico. Si el complemento no está conectado, el error se E_ACCESSDENIED.

Nota

Cualquier llamada a esta API fuera de un complemento VPN conectado producirá un error, ya que el perfil de VPN controla la actividad y las interacciones entre el complemento VPN y el sistema. Se producirá un error en la llamada si el marco de VPN no admite el tipo de transporte especificado implementado por el objeto outerTunnelTransport . El socket no debe haberse conectado en el momento de esta llamada; de lo contrario, se producirá un error de parámetro no válido.

Desde este método, un complemento puede elegir entre las siguientes combinaciones de sockets:

• Un socket TCP (StreamSocket),
• Un socket UDP (DatagramSocket),
• Dos sockets TCP, o
• Dos sockets, un TCP y otro UDP.