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

Определение

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

Windows.Networking.Vpn

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

Параметры

transport

Object

Platform::Object

IInspectable

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

context

Object

Platform::Object

IInspectable

Используемый объект контекста транспорта, например имя узла или сервера.

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

Семейство устройств	Windows 10, version 1803 (появилось в 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v6.0)
Возможности приложения	networkingVpnProvider

Комментарии

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

Заметка

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