System.Tether.Manager.TTetheringProfile.GetConnectionTo

• 親: TTetheringProfile

Delphi

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）、新しい接続のプロトコルの接続に失敗しました。

関連項目

• System.Tether.Manager.TTetheringProfile.CheckProfileIsConnected
• System.Tether.Manager.TTetheringProfile.FConnections
• System.Tether.Manager.TTetheringProfile.FindConnection
• System.Tether.Manager.TTetheringProfile.FindProfile
• System.Tether.Manager.TTetheringProfile.IsProfileConnected