VpnChannel.ReplaceAndAssociateTransport(Object, Object) 方法

定义

命名空间:

Windows.Networking.Vpn

将现有传输替换为新的传输，供 VPN 框架用作将 VPN 插件与 VPN 服务器通信的传输链接。

public:
 virtual void ReplaceAndAssociateTransport(Platform::Object ^ transport, Platform::Object ^ context) = ReplaceAndAssociateTransport;

void ReplaceAndAssociateTransport(IInspectable const& transport, IInspectable const& context);

public void ReplaceAndAssociateTransport(object transport, object context);

function replaceAndAssociateTransport(transport, context)

Public Sub ReplaceAndAssociateTransport (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 框架不支持 传输对象实现 的指定传输类型，则调用将失败。 在此调用时，套接字必须尚未连接，否则调用将失败并出现参数无效错误。