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

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

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

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

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

Inheritance

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によっても提供されます。

Requirements

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