System.Tether.AppProfile.TTetheringAppProfile.SendString
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);
Inhaltsverzeichnis
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 Prozess durch Übermitteln des Strings im Befehl vereinfacht (wodurch der zusätzliche Schritt des Sendens des Strings entfällt), ist ihre Ausführung schneller als die Ausführung von SendStream.
Exceptions
Ein Aufruf von SendString könnte eine der folgenden Exceptions auslösen:
Exception | Exception.Message | Szenarien |
---|---|---|
Profil <Profilbezeichner> ist nicht verbunden. |
| |
Keine verfügbaren Verbindungen zu <Profilbezeichner> |
| |
Verbindung zum Profil <Profilbezeichner> kann nicht hergestellt werden. |
| |
Verbindung zum Profil <Profilbezeichner> kann nicht hergestellt werden. |
|
Siehe auch
- 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
- BDShoppingList (Beispiel)
- MediaPlayer (Beispiel)