次の方法で共有


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

定義

VPN プラグインを VPN サーバーに通信するトランスポート リンクとして、VPN フレームワークで使用する既存のトランスポートを新しいトランスポートに置き換えます。

public:
 virtual void ReplaceAndAssociateTransport(Platform::Object ^ transport, Platform::Object ^ context) = ReplaceAndAssociateTransport;
void ReplaceAndAssociateTransport(IInspectable const& transport, IInspectable const& context);
public void ReplaceAndAssociateTransport(object transport, object context);
function replaceAndAssociateTransport(transport, context)
Public Sub ReplaceAndAssociateTransport (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 フレームワークが、トランスポート オブジェクトによって実装された指定された種類のトランスポートをサポートしていない場合、呼び出しは失敗します。 この呼び出し時にソケットが接続されていない必要があります。そうしないと、呼び出しは無効なパラメーター エラーで失敗します。

適用対象