VpnChannel.AddAndAssociateTransport(Object, Object) メソッド

定義

名前空間:

Windows.Networking.Vpn

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 プラグインとシステム間のアクティビティと相互作用は VPN プロファイルによって制御されるため、接続された VPN プラグインの外部でこの API を呼び出すと失敗します。 VPN フレームワークが、トランスポート オブジェクトによって実装された指定された種類のトランスポートをサポートしていない場合、呼び出しは失敗します。 この呼び出し時にソケットが接続されていない必要があります。そうしないと、呼び出しは無効なパラメーター エラーで失敗します。