IWTSPlugin インターフェイス (tsvirtualchannels.h)

リモート デスクトップ接続 (RDC) クライアント プラグインをリモート デスクトップ接続 (RDC) クライアントによって読み込むことができます。 インターフェイスはプラグインによって実装され、RDC クライアントによって取得および管理されます。

RDC クライアントは、COM オブジェクトをインスタンス化するか、プラグインによって実装された VirtualChannelGetInstance 関数を呼び出すことによって、このインターフェイスのインスタンスを取得します。 インスタンスの取得方法の詳細については、「 DVC プラグインの登録」を参照してください。 いずれの場合も、このインスタンスはリモート デスクトップ接続 (RDC) クライアントの有効期間中保持されます。

COM オブジェクトとして、プラグインをフリー スレッド モデルで実装する必要があります。 IWTSPlugin メソッドはプラグインによって実装されるため、プラグインは呼び出しが異なるスレッドに到着する可能性があることに注意する必要があります。 呼び出しは常にシリアルに到着するため、並列で実行される 2 つの呼び出しを持つことは不可能です。

既存の接続の他の着信接続またはデータがブロックされる可能性があるため、これらの呼び出しを実装でブロックしないでください。

継承

IWTSPlugin インターフェイスは、IUnknown インターフェイスから継承されます。 IWTSPlugin には、次の種類のメンバーもあります。

メソッド

IWTSPlugin インターフェイスには、これらのメソッドがあります。

IWTSPlugin::Connected リモート デスクトップ接続 (RDC) クライアントがリモート デスクトップ セッション ホスト (RD セッション ホスト) サーバーに正常に接続されたことをプラグインに通知します。
IWTSPlugin::D isconnected リモート デスクトップ接続 (RDC) クライアントがリモート デスクトップ セッション ホスト (RD セッション ホスト) サーバーから切断されたことをプラグインに通知します。
IWTSPlugin::Initialize クライアントからプラグインへの最初の呼び出しに使用されます。
IWTSPlugin::Terminated リモート デスクトップ接続 (RDC) クライアントが終了したことをプラグインに通知します。

解説

IWTSPlugin インターフェイスは、リモート デスクトップ WebAuthn リダイレクト機能を有効にするために、%System32%\webauthn.dll によって実装されます。 VirtualChannelGetInstance を呼び出して、このインターフェイスのインスタンスを取得します。これは、webauthn.dll によっても提供されます。

要件

サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	tsvirtualchannels.h