System.Tether.AppProfile.TTetheringAppProfile.SendLongString

• Übergeordnet: TTetheringAppProfile

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);

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	System.Tether.AppProfile.pas System.Tether.AppProfile.hpp	System.Tether.AppProfile	TTetheringAppProfile

Beschreibung

Sendet den angegebenen String an das angegebene Remote-Profil.

Diese Funktion übernimmt die folgenden Parameter:

• AProfile ist das Remote-Profil, das den String erhalten soll.
• Description ist eine Beschreibung des Inhalts des Strings.
• AString ist der String, der gesendet werden soll.

Das Remote-Profil erhält den String als Parameter des Befehls "send string", daher muss das Remote-Profil den String nicht separat akzeptieren und erhalten (wie bei SendStream). Das bedeutet, dass das Remote-Profil nicht wählen kann, ob der String empfangen wird oder nicht. Die Funktion gibt True zurück, wenn das Remote-Profil den Befehl erhalten hat.

SendLongString ist eine synchrone Funktion. Diese Funktion führt eine Anforderung an das Remote-Profil durch, und die Funktionsausführung wird erst beendet, nachdem eine Antwort vom Remote-Profil erhalten wurde. Sie können diese Funktion in einem separaten Thread ausführen.

Hinweis: Da diese Funktion den Vorgang durch Senden des Strings in einem Befehl vereinfacht (und auf diese Weise der zusätzliche Schritt für das Senden des Strings nicht erforderlich ist), ist die Ausführung dieser Funktion schneller als die Ausführung von SendStream.

Exceptions

Der Aufruf von SendLongString könnte eine der folgenden Exceptions auslösen:

Exception	Exception.Message	Szenarien
ETetheringException	Profil <Profilbezeichner> ist nicht verbunden.	AProfile ist nicht verbunden.
	Keine verfügbaren Verbindungen zu <Profilbezeichner>	AProfile verfügt über keine zulässige Verbindung.
	Verbindung zum Profil <Profilbezeichner> kann nicht hergestellt werden.	SendLongString konnte keine Verbindung zu AProfile herstellen.
	Verbindung zum Profil <Profilbezeichner> kann nicht hergestellt werden.	SendLongString konnte keine Verbindung zu AProfile herstellen.

Beachtung: SendLongString darf nur verwendet werden, wenn die Länge des Strings größer als ~1,3 KB ist. Ansonsten muss SendString verwendet werden.

Siehe auch

• System.Tether.Manager.TTetheringProfileInfo
• System.String

• System.Tether.AppProfile.TCustomRemoteItem.IsTemp
• System.Tether.AppProfile.TTetheringAppProfile.OnAcceptResource
• System.Tether.AppProfile.TTetheringAppProfile.OnResourceReceived
• System.Tether.AppProfile.TRemoteResource
• System.Tether.AppProfile.TRemoteResource.Value

• System.Tether.Manager.TTetheringProfile.Manager
• System.Tether.Manager.TTetheringManager.RemoteProfiles

• System.Tether.AppProfile.TTetheringAppProfile.SendStream

• Multithread-Anwendungen entwickeln
• BDShoppingList sample
• MediaPlayer sample