VpnChannel.AssociateTransport(Object, Object) 方法

定義

命名空間:

Windows.Networking.Vpn

準備並將 VPN 架構使用的傳輸標示為將 VPN 外掛程式通訊至 VPN 伺服器的傳輸連結。 在與 VPN 架構 API 相關的任何其他作業之前，必須先執行此呼叫。

public:
 virtual void AssociateTransport(Platform::Object ^ mainOuterTunnelTransport, Platform::Object ^ optionalOuterTunnelTransport) = AssociateTransport;

void AssociateTransport(IInspectable const& mainOuterTunnelTransport, IInspectable const& optionalOuterTunnelTransport);

public void AssociateTransport(object mainOuterTunnelTransport, object optionalOuterTunnelTransport);

function associateTransport(mainOuterTunnelTransport, optionalOuterTunnelTransport)

Public Sub AssociateTransport (mainOuterTunnelTransport As Object, optionalOuterTunnelTransport As Object)

參數

mainOuterTunnelTransport

Object

Platform::Object

IInspectable

套接字傳輸 IInspectable 物件。 此物件可以是 Windows.Networking.Sockets.StreamSocket 或 Windows.Networking.DatagramSocket。 此套接字會控制 VPN 伺服器的連線，並用來傳送封裝的 IP 封包和接收封裝的數據。 套接字必須在呼叫點取消連接。

optionalOuterTunnelTransport

Object

Platform::Object

IInspectable

套接字傳輸的選擇性 IInspectable 物件。 此物件可以是 Windows.Networking.Sockets.StreamSocket 或 Windows.Networking.DatagramSocket。 此套接字會控制 VPN 伺服器的連線，並用來傳送封裝的 IP 封包和接收封裝的數據。

Windows 需求

應用程式功能

networkingVpnProvider

備註

如果函式成功，傳回值會 S_OK，否則函式會傳回描述特定失敗的錯誤 hresult 值。 如果外掛程式未連線，錯誤將會 E_ACCESSDENIED。

注意

線上 VPN 外掛程式外部對此 API 的任何呼叫都會失敗，因為 VPN 外掛程式與系統之間的活動和互動是由 VPN 設定檔所控制。 如果 VPN 架構不支援外部TunnelTransport 物件 所實作的指定傳輸類型，呼叫將會失敗。 套接字在呼叫時必須尚未連線，否則呼叫將會失敗，並出現無效的參數錯誤。

從此方法中，外掛程式可以選擇下列套接字組合：

• 一個 TCP 套接字 （StreamSocket），
• 一個 UDP 套接字 （DatagramSocket），
• 兩個 TCP 套接字，或
• 兩個套接字，一個 TCP 和一個 UDP。