System.Tether.Manager.TTetheringProfile.GetConnectionTo

• Aller au parent : 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);

Propriétés

Type	Visibilité	Source	Unité	Parent
function	protected	System.Tether.Manager.pas System.Tether.Manager.hpp	System.Tether.Manager	TTetheringProfile

Description

Renvoie une connexion qui fournit l'accès au profil distant spécifié.

Utilisez AProtocolType et AnAdapterType pour déterminer le type de protocole et d'adaptateur de la connexion résultante. Ces deux paramètres doivent être utilisés conjointement. Si vous fournissez une valeur non vide pour l'un d'eux, vous devez aussi fournir une valeur non vide pour l'autre.

Utilisez Connect pour spécifier si vous voulez que GetConnectionTo garantisse que le protocole de la connexion renvoyée est connecté (True) ou déconnecté (False).

Exceptions

GetConnectionTo peut déclencher les exceptions suivantes :

Exception	Message	Scénarios
ETetheringException	Pas de connexions disponibles à <profil distant>	Aucune connexion n'est disponible pour AProfile. Votre profil ne prend pas en charge la combinaison spécifiée de AProtocolType et AnAdapterType. Il n'y a pas de connexions disponibles pour AProfile avec la combinaison spécifiée de AProtocolType et de AnAdapterType.
	Vous devez ajouter un protocole et un adaptateur pour la connexion au <profil distant>	Vous avez spécifié une valeur non vide pour AProtocolType ou AnAdapterType, mais pas pour les deux.
	Impossible d'obtenir une connexion au profil <profil distant>	La méthode CreateInstance du protocole sélectionné pour établir une connexion a déclenché une exception. La méthode StartCommunication du protocole sélectionné pour établir une connexion a déclenché une exception.
	Impossible de se connecter au profil <profil distant>	Vous avez demandé une connexion établie (Connect équivalent à True) mais la connexion au protocole de la nouvelle connexion a échoué.

Voir aussi

• 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