VpnChannel.AssociateTransport(Object, Object) 方法

定義

準備並將 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.StreamSocketWindows.Networking.DatagramSocket。 此套接字會控制 VPN 伺服器的連線,並用來傳送封裝的 IP 封包和接收封裝的數據。 套接字必須在呼叫點取消連接。

optionalOuterTunnelTransport
Object

Platform::Object

IInspectable

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

Windows 需求

應用程式功能
networkingVpnProvider

備註

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

注意

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

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

  • 一個 TCP 套接字 (StreamSocket),
  • 一個 UDP 套接字 (DatagramSocket),
  • 兩個 TCP 套接字,或
  • 兩個套接字,一個 TCP 和一個 UDP。

適用於