VpnChannel.ReplaceAndAssociateTransport(Object, Object) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将现有传输替换为用于 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 框架不支持 传输 对象实现的指定传输类型,则调用将失败。 此调用时,套接字必须尚未连接,否则调用将失败并出现无效参数错误。