Поделиться через

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.

Применяется к