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