VpnChannel.StartReconnectingTransport(Object, Object) Method

Definition

Namespace:

Windows.Networking.Vpn

Reconnect the socket transport. Transport and transport context are the only parameters that can be changed on a socket transport reconnection.

Important

This API is not implemented, and we recommend that you do not call it.

public:
 virtual void StartReconnectingTransport(Platform::Object ^ transport, Platform::Object ^ context) = StartReconnectingTransport;

void StartReconnectingTransport(IInspectable const& transport, IInspectable const& context);

public void StartReconnectingTransport(object transport, object context);

function startReconnectingTransport(transport, context)

Public Sub StartReconnectingTransport (transport As Object, context As Object)

Parameters

transport

Object

Platform::Object

IInspectable

An IInspectable object for socket transport. This object can be a Windows.Networking.Sockets.StreamSocket or a Windows.Networking.DatagramSocket. This socket will control the connection to the VPN server and will be used to send encapsulated IP packets and receive encapsulated data. The socket must be unconnected at the point of the call.

context

Object

Platform::Object

IInspectable

The transport context object to use, for example the name of a host or server.

Windows requirements

Device family	Windows 10, version 1803 (introduced in 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v6.0)
App capabilities	networkingVpnProvider

Remarks

If the function succeeds, the return value is S_OK, otherwise the function will return an error hresult value describing the specific failure. If the plug-in is not connected, the error will be E_ACCESSDENIED.

Note

Any call to this API outside of a connected VPN plug-in will fail, as activity and interactions between the VPN plug-in and the system are controlled by the VPN profile. The call will fail if the VPN framework does not support the specified type of transport implemented by the transport object. The socket must have not been connected at the time of this call, otherwise the call will fail with an invalid parameter error.

A plugin may choose between the following combinations of sockets:

• One TCP socket (StreamSocket),
• One UDP socket (DatagramSocket),
• Two TCP sockets, or
• Two sockets, one TCP and one UDP.