VpnChannel.Start Método

Definición

Espacio de nombres:

Windows.Networking.Vpn

Crea el canal VPN que usará el complemento VPN. También crea una interfaz de red L3 para las aplicaciones de la máquina cliente para poder ver la red corporativa.

public:
 virtual void Start(IVectorView<HostName ^> ^ assignedClientIPv4list, IVectorView<HostName ^> ^ assignedClientIPv6list, VpnInterfaceId ^ vpnInterfaceId, VpnRouteAssignment ^ routeScope, VpnNamespaceAssignment ^ namespaceScope, unsigned int mtuSize, unsigned int maxFrameSize, bool optimizeForLowCostNetwork, Platform::Object ^ mainOuterTunnelTransport, Platform::Object ^ optionalOuterTunnelTransport) = Start;

/// [Windows.Foundation.Metadata.Overload("Start")]
void Start(IVectorView<HostName> const& assignedClientIPv4list, IVectorView<HostName> const& assignedClientIPv6list, VpnInterfaceId const& vpnInterfaceId, VpnRouteAssignment const& routeScope, VpnNamespaceAssignment const& namespaceScope, uint32_t const& mtuSize, uint32_t const& maxFrameSize, bool const& optimizeForLowCostNetwork, IInspectable const& mainOuterTunnelTransport, IInspectable const& optionalOuterTunnelTransport);

[Windows.Foundation.Metadata.Overload("Start")]
public void Start(IReadOnlyList<HostName> assignedClientIPv4list, IReadOnlyList<HostName> assignedClientIPv6list, VpnInterfaceId vpnInterfaceId, VpnRouteAssignment routeScope, VpnNamespaceAssignment namespaceScope, uint mtuSize, uint maxFrameSize, bool optimizeForLowCostNetwork, object mainOuterTunnelTransport, object optionalOuterTunnelTransport);

function start(assignedClientIPv4list, assignedClientIPv6list, vpnInterfaceId, routeScope, namespaceScope, mtuSize, maxFrameSize, optimizeForLowCostNetwork, mainOuterTunnelTransport, optionalOuterTunnelTransport)

Public Sub Start (assignedClientIPv4list As IReadOnlyList(Of HostName), assignedClientIPv6list As IReadOnlyList(Of HostName), vpnInterfaceId As VpnInterfaceId, routeScope As VpnRouteAssignment, namespaceScope As VpnNamespaceAssignment, mtuSize As UInteger, maxFrameSize As UInteger, optimizeForLowCostNetwork As Boolean, mainOuterTunnelTransport As Object, optionalOuterTunnelTransport As Object)

Parámetros

assignedClientIPv4list

IVectorView<HostName>

IReadOnlyList<HostName>

Puntero a un vector IVectorView< Windows.Networking.HostName *> que especifica la dirección IPv4 asignada por el servidor VPN al cliente VPN. La dirección debe establecerse en la interfaz VPN L3. Si null , se usa DHCPv4.

assignedClientIPv6list

IVectorView<HostName>

IReadOnlyList<HostName>

Puntero a un Windows.Networking.HostName estructura que especifica la dirección IPv6 asignada por el servidor VPN al cliente VPN y que debe establecerse en la interfaz L3 de VPN. Si null, se usa DHCPv6 o RD.

vpnInterfaceId

VpnInterfaceId

Puntero a vpnInterfaceId.

routeScope

VpnRouteAssignment

Puntero a la clase Windows.Networking.VpnRouteAssignment que representa las rutas que deben estar asociadas o no asociadas a la interfaz VPN.

namespaceScope

VpnNamespaceAssignment

Puntero a la clase Windows.Networking.DomainNameAssignment que representa la lista de prefijos de nombre asociados al canal VPN, incluidos sus servidores DNS y proxy.

mtuSize

UInt32

unsigned int

uint32_t

Valor UINT16 que especifica el tamaño de MTU de la interfaz de red VPN L3. Este es también el tamaño de IVpnPacketBuffers en el grupo de recepción. Este valor debe configurarse para que sea como máximo 1400.

maxFrameSize

UInt32

unsigned int

uint32_t

Valor UINT16 que especifica el tamaño máximo del marco definido por la encapsulación del protocolo VPN sin contar el outerTunnelTransport. Este es también el tamaño del IVpnPacketBuffers en el grupo de envío. Este valor debe configurarse como mtuSize + [tamaño de encabezados de encapsulación] y debe ser <=1500. Si fuera mayor que 1500 mtuSize o tamaño de encabezado de encapsulación debería reducirse, ya que la plataforma limita los marcos a 1500.

optimizeForLowCostNetwork

Boolean

bool

Un booleano que especifica si el marco de VPN debe supervisar y usar redes de bajo costo a medida que están disponibles. Si TRUE el marco de VPN invocará la devolución de llamada connect() al complemento VPN para volver a conectarla cada vez que se costó la red anterior y estará disponible una nueva red de bajo costo.

mainOuterTunnelTransport

Object

Platform::Object

IInspectable

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

optionalOuterTunnelTransport

Object

Platform::Object

IInspectable

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

Atributos

OverloadAttribute

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 la actividad y las interacciones entre el complemento VPN y el sistema se controlan mediante el perfil de VPN. Solo puede haber un perfil de VPN por proceso porque el complemento VPN solo tiene asignado un perfil de VPN y, si un autor de la llamada fuera a crear más de un objeto de perfil, todos harán referencia a la misma configuración.

Si la propiedad de outertTunnelTransport se transfiere mediante el marco de VPN. Llamar a este método varias veces con los mismos parámetros no tendrá ningún efecto. Al llamar a este método varias veces con variaciones en los valores de parámetro, se asegurará de que el canal se actualice con los valores más recientes sin interrupciones en otras propiedades.

Solo puede haber un canal VPN por proceso y, por tanto, un complemento VPN solo puede tener asignado un canal VPN. El de mtuSize siempre debe ser menor que el maxFrameSize.