VpnChannel.AddAndAssociateTransport(Object, Object) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
准备、标记和创建传输,供 VPN 框架用作将 VPN 插件与 VPN 服务器通信的传输链接。 必须在与 VPN 框架 API 相关的任何其他操作之前执行此调用。
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。
注意
在连接的 VPN 插件外部调用此 API 将失败,因为 VPN 插件与系统之间的活动和交互由 VPN 配置文件控制。 如果 VPN 框架不支持 传输 对象实现的指定传输类型,则调用将失败。 此调用时,套接字必须尚未连接,否则调用将失败并出现无效参数错误。