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


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

Определение

Подготавливает, помечает и создает транспорт для использования платформой 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-платформа не поддерживает указанный тип транспорта, реализованный объектом транспорта. Сокет не должен быть подключен во время этого вызова, в противном случае вызов завершится ошибкой недопустимого параметра.

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