System.Tether.AppProfile.TTetheringAppProfile.SendStream

• Aller au parent : 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);

Propriétés

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

Description

Envoie le flux spécifié vers le profil distant spécifié et renvoie True en cas de réussite ou False en cas d'échec.

Cette fonction reçoit les paramètres suivants :

• AProfile est le profil distant qui reçoit le flux.
• Description est une description du contenu du flux.
• AStream est le flux à envoyer.

Le profil distant reçoit le flux en tant que ressource temporelle. Le profil distant qui reçoit le flux peut décider d'accepter ou non le flux et, en cas d'acceptation, lire le flux.

SendStream renvoie False en cas d'erreur de connexion durant la transmission du flux. Sinon, elle renvoie True. Le flux est envoyé vers le profil distant avant que ce dernier décide s'il l'accepte. Il se peut donc que le profil distant rejette le flux mais que SendStream renvoie True car il a déjà été envoyé avec succès. Il n'existe pas de mécanisme intégré permettant de savoir si le profil distant a accepté ou non le flux.

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

Exceptions

Un appel de SendStream peut déclencher l'une des exceptions suivantes :

Exception	Exception.Message	Scénarios
ETetheringException	Impossible de se connecter au profil <identificateur de profil>	Le gestionnaire de votre profil ne comporte pas AProfile dans sa liste de profils distants.
	Le profil <identificateur de profil> n'est pas connecté.	AProfile n'est pas connecté.
	Aucune connexion disponible pour <l'identificateur de profil>	AProfile ne comporte aucune connexion permise.
	Impossible d'obtenir une connexion au profil <identificateur de profil>.	SendStream n'a pas pu obtenir une connexion à AProfile.
	Impossible de se connecter au profil <identificateur de profil>	SendStream n'a pas pu se connecter à AProfile.

Voir aussi

• 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

• Ecriture d'applications multithread

• System.Tether.AppProfile.TTetheringAppProfile.SendString

• Exemple PhotoWall