Compartilhar via


VpnChannel.AssociateTransport(Object, Object) Método

Definição

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.

Nota

Qualquer chamada para 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:

Aplica-se a