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

このメソッドから、プラグインは次のソケットの組み合わせから選択できます。

• 1 つの TCP ソケット (StreamSocket)
• 1 つの UDP ソケット (DatagramSocket)
• 2 つの TCP ソケット、または
• 2 つのソケット、1 つの TCP と 1 つの UDP。