次の方法で共有

IRDPSRAPIViewer::StartReverseConnectListener メソッド (rdpencomapi.h)

  • [アーティクル]

[IRDPSRAPIViewer インターフェイスは、Windows 10 バージョン 1709 の時点で UWP アプリケーションで使用できなくなりました。 デスクトップ アプリでは引き続きサポートされています。]

共有元からビューアーへの逆引き接続を受け入れるためのリスナーを開始するか、または共有者がビューアーへの逆引き接続に使用する接続文字列を取得します。

構文

HRESULT StartReverseConnectListener(
  [in]  BSTR bstrConnectionString,
  [in]  BSTR bstrUserName,
  [in]  BSTR bstrPassword,
  [out] BSTR *pbstrReverseConnectString
);

パラメーター

[in] bstrConnectionString

種類: BSTR

リスナーを開始するために共有者が使用する接続文字列。

[in] bstrUserName

種類: BSTR

認証に使用するユーザー名。

[in] bstrPassword

種類: BSTR

認証に使用するパスワード。

[out] pbstrReverseConnectString

種類: BSTR*

IRDPSRAPISharingSession::ConnectToClient メソッドを使用してビューアーへの逆接続に使用できる接続文字列を受け取る BSTR へのポインター。

戻り値

種類: HRESULT

メソッドが成功した場合、戻り値は S_OK。 それ以外の場合、戻り値はエラー コードです。

解説

このメソッドは、次の 2 つの個別の操作を実行するために使用されます。

  • 1 つ目は、ビューアーがビューアーへの逆接続に使用する接続文字列を取得できるようにすることです。 そのためには、 bstrConnectionString、 bstrUserName、および bstrPassword パラメーターはすべて NULL である必要があります。 その後、ビューアーは、接続文字列をファイルに格納し、ファイルを共有者と共有するなど、アプリケーション定義のメソッドでこの接続文字列を共有者に送信します。
  • 2 つ目の操作は、共有元からの逆引き接続試行にwatchするリスナーを開始することです。 この操作の場合、 pbstrReverseConnectString パラメーターは NULL である必要があります。
このプロシージャのイベントの通常のシーケンスは次のとおりです。
  1. ビューアーは StartReverseConnectListener メソッドを呼び出して接続文字列を取得し、bstrConnectionString、bstrUserName、および bstrPassword パラメーターに NULL を渡します。
  2. ビューアーは StartReverseConnectListener メソッドを呼び出してリバース接続リスナーを開始し、pbstrReverseConnectString パラメーターに NULL を渡し、bstrConnectionString、bstrUserName、および bstrPassword パラメーターの有効な値を渡します。
  3. ビューアーは、手順 1 で取得した接続文字列を共有側に送信します。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー rdpencomapi.h
[DLL] RdpEncom.dll

関連項目

IRDPSRAPIViewer