VpnChannel.ReplaceAndAssociateTransport(Object, Object) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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
- 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 フレームワークが、トランスポート オブジェクトによって実装された指定された種類のトランスポートをサポートしていない場合、呼び出しは失敗します。 この呼び出し時にソケットが接続されていない必要があります。そうしないと、呼び出しは無効なパラメーター エラーで失敗します。