System.Tether.AppProfile.TTetheringAppProfile.SendLongString

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi 

function SendLongString(const AProfile: TTetheringProfileInfo; const Description, AString: string): Boolean;

C++ 

bool __fastcall SendLongString(const System::Tether::Manager::TTetheringProfileInfo &AProfile, const System::UnicodeString Description, const System::UnicodeString AString);

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.Tether.AppProfile.pas
System.Tether.AppProfile.hpp
 System.Tether.AppProfile TTetheringAppProfile


Description

Envoie la chaîne spécifiée vers le profil distant spécifié.

Cette fonction reçoit les paramètres suivants :

  • AProfile est le profil distant qui reçoit la chaîne.
  • Description est une description du contenu de la chaîne.
  • AString est la chaîne à envoyer.

Le profil distant reçoit la chaîne en tant que paramètre de la commande "envoyer la chaîne". Par conséquent, il n’est pas nécessaire que le profil distant accepte et reçoive la chaîne séparément (comme c’est le cas avec SendStream). Cela signifie que le profil distant ne peut pas choisir de recevoir ou de ne pas recevoir la chaîne. La fonction renvoie True si le profil distant a reçu la commande.

SendLongString est une fonction synchrone. Cette fonction soumet une demande au profil distant, et son exécution se termine uniquement après l'obtention d'une réponse de la part du profil distant. Vous pouvez, si vous le souhaitez, utiliser un thread distinct pour exécuter cette fonction.

Remarque: Comme cette fonction simplifie le processus en envoyant la chaîne dans la commande (éliminant ainsi l’étape supplémentaire consistant à envoyer la chaîne), son exécution est plus rapide que celle de SendStream.

Exceptions

Un appel à SendLongString peut déclencher l'une quelconque des exceptions suivantes :

Exception Exception.Message Scénarios

ETetheringException

Le profil <identificateur de profil> n'est pas connecté.

  • AProfile n'est pas connecté.

Pas de connexions disponibles à <identificateur de profil>

Impossible d'obtenir une connexion au profil <identificateur de profil>.

Impossible de se connecter au profil <identificateur de profil>.

Attention: SendLongString doit uniquement être utilisée si la longueur de la chaîne est supérieure à ~1,3 Ko ; sinon, SendString doit être utilisée.

Voir aussi

Récupérée de « http://docwiki.embarcadero.com/Libraries/Sydney/f/index.php?title=System.Tether.AppProfile.TTetheringAppProfile.SendLongString&oldid=781496 »