System.Tether.AppProfile.TTetheringAppProfile.SendStream

• Übergeordnet: TTetheringAppProfile

Delphi

function SendStream(const AProfile: TTetheringProfileInfo; const Description: string; const AStream: TStream): Boolean;

C++

bool __fastcall SendStream(const System::Tether::Manager::TTetheringProfileInfo &AProfile, const System::UnicodeString Description, System::Classes::TStream* const AStream);

Eigenschaften

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

Beschreibung

Sendet den angegebenen Stream an das angegebene Remote-Profil und gibt bei Erfolg True und bei einem Fehler False zurück.

Diese Funktion erhält die folgenden Parameter:

• AProfile ist das Remote-Profil, das den Stream empfangen soll.
• Description ist eine Beschreibung des Inhalts des Streams.
• AStream ist der Stream, der gesendet werden soll.

Das Remote-Profil empfängt den Stream als eine temporäre Ressource. Das Remote-Profil, das den Stream empfängt, kann den Stream annehmen oder ablehnen und bei Annahme den Stream lesen.

SendStream gibt False zurück, wenn während der Übertragung des Streams ein Verbindungsfehler auftritt. Andernfalls wird True zurückgegeben. Der Stream wird an das Remote-Profil gesendet, bevor das Remote-Profil über die Annahme oder Ablehnung des Streams entscheidet. Daher kann es vorkommen, dass das Remote-Profil den Stream zurückweist, aber SendStream True zurückgibt, weil der Stream bereits erfolgreich gesendet wurde. Es gibt keinen integrierten Mechanismus, um festzustellen, ob das Remote-Profil den Stream angenommen hat.

SendStream 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.

Exceptions

Ein Aufruf von SendStream könnte eine der folgenden Exceptions auslösen:

Exception	Exception.Message	Szenarien
ETetheringException	Profil <Profilbezeichner> wurde nicht gefunden.	Der Manager Ihres Profils enthält AProfile nicht in der Liste der Remote-Profile.
	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.	SendStream konnte keine Verbindung zu AProfile herstellen.
	Verbindung zum Profil <Profilbezeichner> kann nicht hergestellt werden.	SendStream konnte die Verbindung mit AProfile nicht herstellen.

Siehe auch

• System.Tether.Manager.TTetheringProfileInfo
• System.String
• System.Classes.TStream

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

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

• Multithread-Anwendungen entwickeln

• System.Tether.AppProfile.TTetheringAppProfile.SendString

• PhotoWall (Beispiel)