VpnChannel.AddAndAssociateTransport(Object, Object) Método

Definição

Namespace:

Windows.Networking.Vpn

Prepara, marca e cria 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 AddAndAssociateTransport(Platform::Object ^ transport, Platform::Object ^ context) = AddAndAssociateTransport;

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

public void AddAndAssociateTransport(object transport, object context);

function addAndAssociateTransport(transport, context)

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

Parâmetros

transport

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.

context

Object

Platform::Object

IInspectable

O objeto de contexto de transporte a ser usado, por exemplo, o nome de um host ou servidor.

Requisitos do Windows

Família de dispositivos	Windows 10, version 1803 (introduzida na 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v6.0)
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 de transporte . 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.