System.Tether.Manager.TTetheringProfile.GetConnectionTo

• Übergeordnet: 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);

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	protected	System.Tether.Manager.pas System.Tether.Manager.hpp	System.Tether.Manager	TTetheringProfile

Beschreibung

Gibt eine Verbindung zurück, die den Zugriff auf das angegebene Remote-Profil bereitstellt.

Verwenden Sie AProtocolType und AnAdapterType, um den Typ des Protokolls und Adapters der resultierenden Verbindung festzulegen. Diese beiden Parameter müssen gemeinsam verwendet werden; wenn Sie für einen dieser Parameter einen Wert angeben, müssen Sie auch einen Wert für den anderen angeben.

Mit Connect legen Sie fest, ob GetConnectionTo sicherstellen soll, dass das Protokoll der zurückgegebenen Verbindung verbunden (True) ist oder nicht (False).

Exceptions

GetConnectionTo kann die folgenden Exceptions auslösen:

Exception	Meldung	Szenarien
ETetheringException	Keine verfügbaren Verbindungen zu <Remote-Profil>	Für AProfile sind keine verfügbaren Verbindungen vorhanden. Ihr Profil unterstützt die angegebene Kombination von AProtocolType und AnAdapterType nicht. Es gibt keine verfügbaren Verbindungen für AProfile mit der angegebenen Kombination von AProtocolType und AnAdapterType.
	Sie müssen ein Protokoll und einen Adapter für die Verbindung mit <Remote-Profil> hinzufügen	Sie haben für AProtocolType oder AnAdapterType einen nicht leeren Wert angegeben, aber nicht für beide.
	Verbindung mit Profil <Remote-Profil> kann nicht hergestellt werden	Die Methode CreateInstance des Protokolls, das für die Einrichtung einer Verbindung ausgewählt wurde, hat eine Exception ausgelöst. Die Methode StartCommunication des Protokolls, das für die Einrichtung einer Verbindung ausgewählt wurde, hat eine Exception ausgelöst.
	Verbindung zum Profil <Remote-Profil> kann nicht hergestellt werden	Sie haben eine eingerichtete Verbindung angefordert (Connect ist True), aber die Verbindung mit dem Protokoll der neuen Verbindung ist fehlgeschlagen.

Siehe auch

• 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