VpnChannel.AssociateTransport(Object, Object) Método

Definição

Namespace:

Windows.Networking.Vpn

Prepara e marca o transporte para uso pela estrutura VPN como um link de transporte comunicando o plug-in VPN ao servidor VPN. Essa chamada deve ser executada antes de qualquer outra operação relacionada às APIs da estrutura 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

Um objeto IInspectable para transporte de soquete. Esse objeto pode ser um Windows.Networking.Sockets.StreamSocket ou um Windows.Networking.DatagramSocket. Esse soquete controlará a conexão com o servidor VPN e será usado para enviar pacotes IP encapsulados e receber dados encapsulados. O soquete deve estar desconectado no ponto da chamada.

optionalOuterTunnelTransport

Object

Platform::Object

IInspectable

Um objeto IInspectable opcional para transporte de soquete. Esse objeto pode ser um Windows.Networking.Sockets.StreamSocket ou um Windows.Networking.DatagramSocket. Esse soquete controlará a conexão com o servidor VPN e será usado para enviar pacotes IP encapsulados e receber dados encapsulados.

Requisitos do Windows

Funcionalidades do aplicativo

networkingVpnProvider

Comentários

Se a função for bem-sucedida, o valor retornado será S_OK, caso contrário, a função retornará um valor hresult de erro que descreve a falha específica. Se o plug-in não estiver conectado, o erro será E_ACCESSDENIED.

Observação

Qualquer chamada a essa API fora de um plug-in VPN conectado falhará, pois a atividade e as interações entre o plug-in vpn e o sistema são controladas pelo perfil vpn. A chamada falhará se a estrutura VPN não der suporte ao tipo de transporte especificado implementado pelo objeto outerTunnelTransport . O soquete não deve ter sido conectado no momento dessa chamada, caso contrário, a chamada falhará com um erro de parâmetro inválido.

Nesse método, um plug-in pode escolher entre as seguintes combinações de soquetes:

• Um soquete TCP (StreamSocket),
• Um soquete UDP (DatagramSocket),
• Dois soquetes TCP ou
• Dois soquetes, um TCP e um UDP.