VpnChannel.AssociateTransport(Object, Object) Метод

Определение

Пространство имен:

Windows.Networking.Vpn

Подготавливает и помечает транспорт для использования платформой VPN в качестве транспортного канала, сообщающего подключаемый модуль VPN к VPN-серверу. Этот вызов необходимо выполнить перед любыми другими операциями, связанными с API платформы 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)

Параметры

mainOuterTunnelTransport

Object

Platform::Object

IInspectable

Объект IInspectable для транспорта сокета. Это может быть windows.Networking.Sockets.StreamSocket или Windows.Networking.DatagramSocket. Этот сокет будет управлять подключением к VPN-серверу и будет использоваться для отправки инкапсулированных IP-пакетов и получения инкапсулированных данных. Сокет должен быть отключен в точке вызова.

optionalOuterTunnelTransport

Object

Platform::Object

IInspectable

Необязательный объект IInspectable для транспорта сокета. Это может быть windows.Networking.Sockets.StreamSocket или Windows.Networking.DatagramSocket. Этот сокет будет управлять подключением к VPN-серверу и будет использоваться для отправки инкапсулированных IP-пакетов и получения инкапсулированных данных.

Требования к Windows

Возможности приложения

networkingVpnProvider

Комментарии

Если функция выполнена успешно, возвращаемое значение S_OK, в противном случае функция вернет значение ошибки hresult, описывающее конкретный сбой. Если подключаемый модуль не подключен, ошибка будет E_ACCESSDENIED.

Примечание

Любой вызов этого API за пределами подключаемого подключаемого модуля VPN завершится ошибкой, так как действия и взаимодействие между подключаемым модулем VPN и системой управляются профилем VPN. Вызов завершится ошибкой, если платформа VPN не поддерживает указанный тип транспорта, реализованный объектом outerTunnelTransport . Сокет не должен быть подключен во время этого вызова, в противном случае вызов завершится ошибкой недопустимого параметра.

В этом методе подключаемый модуль может выбрать один из следующих сочетаний сокетов:

• Один сокет TCP (StreamSocket),
• Один сокет UDP (DatagramSocket),
• Два сокета TCP, или
• Два сокета, один TCP и один UDP.