System.Tether.AppProfile.TTetheringAppProfile.SendString

• Übergeordnet: TTetheringAppProfile

Delphi

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

C++

bool __fastcall SendString(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 erhält die folgenden Parameter:

• AProfile ist das Remote-Profil, das den String empfangen 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 "String senden"; daher muss das Remote-Profil den String nicht separat akzeptieren und erhalten (wie im Fall von SendStream). Das bedeutet, dass das Remote-Profil den String nicht ablehnen kann. Die Funktion gibt True zurück, wenn das Remote-Profil den Befehl erhalten hat.

SendString ist eine synchrone Funktion. Diese Funktion führt eine Anforderung an das Remote-Profil durch, und die Funktion wird erst nach einer Antwort vom Remote-Profil beendet. Sie sollten diese Funktion in einem eigenen 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

Ein Aufruf von SendString 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 hat keine zulässige Verbindung.
	Verbindung zum Profil <Profilbezeichner> kann nicht hergestellt werden.	SendString konnte keine Verbindung zu AProfile herstellen.
	Verbindung zum Profil <Profilbezeichner> kann nicht hergestellt werden.	SendString konnte die Verbindung mit AProfile nicht herstellen.

Beachtung: SendString darf nur verwendet werden, wenn die Länge des Strings kleiner als ~1,3 KB ist. Ansonsten muss SendLongString 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

• Multithread-Anwendungen entwickeln

• System.Tether.AppProfile.TTetheringAppProfile.SendStream

• BDShoppingList (Beispiel)
• MediaPlayer (Beispiel)