System.Tether.Manager.TTetheringProfile.GetConnectionTo

提供: Appmethod Libraries
移動先: 案内検索

Object Pascal

function GetConnectionTo(const AProfile: TTetheringProfileInfo; const AProtocolType: TTetheringProtocolType = '';  const AnAdapterType: TTetheringAdapterType = ''; Connect: Boolean = True): TTetheringConnection; virtual;

C++

virtual TTetheringConnection* __fastcall GetConnectionTo(const TTetheringProfileInfo &AProfile, const System::UnicodeString AProtocolType = System::UnicodeString(), const System::UnicodeString AnAdapterType = System::UnicodeString(), bool Connect = true);

プロパティ

種類 可視性 ソース ユニット
function protected
System.Tether.Manager.pas
System.Tether.Manager.hpp
System.Tether.Manager TTetheringProfile


説明

指定されたリモート プロファイルにアクセスするための接続を返します。

<AProtocolType> と <AnAdapterType> を使って、返される接続のプロトコルアダプタの種類を指定します。この 2 つのパラメータはセットで使用しなければなりません。つまり、一方に空でない値を指定した場合には、もう一方にも空でない値を指定しなければなりません。

<Connect> を使って、GetConnectionTo で返される接続のプロトコル接続済みにしたいか(True)したくないか(False)を指定します。

例外

GetConnectionTo では、次の例外が発生する可能性があります。

例外 メッセージ シナリオ

ETetheringException

<リモート プロファイル> への使用可能な接続がありません

  • <AProfile> への使用可能な接続がありません。
  • 指定した <AProtocolType> と <AnAdapterType> の組み合わせをプロファイルがサポートしていません。
  • <AProfile> への使用可能な接続の中に、指定した <AProtocolType> と <AnAdapterType> の組み合わせのものがありません。

<リモート プロファイル> に接続するためのプロトコルとアダプタを追加する必要があります

  • <AProtocolType> と <AnAdapterType> の一方にだけ空でない値を指定しました。

プロファイル <リモート プロファイル> への接続を取得できません

  • 接続を確立するために選択されたプロトコルの CreateInstance メソッドで例外が発生しました。
  • 接続を確立するために選択されたプロトコルの StartCommunication メソッドで例外が発生しました。

プロファイル <リモート プロファイル> に接続できません

  • 確立済みの接続を要求したが(<Connect> が True)、新しい接続のプロトコル接続に失敗しました。

関連項目