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 架構不支援 傳輸 物件所實作的指定傳輸類型,呼叫將會失敗。 套接字在呼叫時必須尚未連線,否則呼叫將會失敗,並出現無效的參數錯誤。