System.Tether.AppProfile.TTetheringAppProfile.SubscribeToRemoteItem

• Aller au parent : TTetheringAppProfile

Delphi

function SubscribeToRemoteItem(const AProfile: TTetheringProfileInfo; const ARemoteItem: TCustomRemoteItem): Boolean; overload;
function SubscribeToRemoteItem(const AProfile: TTetheringProfileInfo; const ARemoteItemName: string): Boolean; overload;

C++

bool __fastcall SubscribeToRemoteItem(const System::Tether::Manager::TTetheringProfileInfo &AProfile, TCustomRemoteItem* const ARemoteItem)/* overload */;
bool __fastcall SubscribeToRemoteItem(const System::Tether::Manager::TTetheringProfileInfo &AProfile, const System::UnicodeString ARemoteItemName)/* overload */;

Propriétés

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

Description

Active la souscription de ce profil d'application à la ressource distante spécifiée du profil distant spécifié pour les mises à jour.

Pour spécifier la ressource distante à laquelle souscrire, vous pouvez utiliser l'un des ensembles de paramètres suivants :

• Fournissez le profil d'application distant contenant la ressource distante en tant que instance de TTetheringProfileInfo et le nom de la ressource distante.

La propriété RemoteProfiles de votre composant TTetheringManager fournit une liste des profils d'application distants connectés à votre profil.

• Fournissez le profil d'application distant contenant la ressource distante en tant que instance de TTetheringProfileInfo et de TCustomRemoteItem.

Votre composant TTetheringAppProfile fournit une méthode, GetRemoteProfileActions, qui renvoie une liste des ressources distantes partagées par un profil d'application distant donné, spécifié en tant que instance de TTetheringProfileInfo.

Lorsque la valeur d'une ressource distante portant le même nom que l'instance de TCustomRemoteItem souscrite change, la valeur de l'instance de TCustomRemoteItem souscrite est mise à jour, et l'événement OnResourceUpdated se produit.

Remarques :

• Pour lire la valeur à partir de l'instance de TCustomRemoteItem souscrite, vous devez convertir cette instance en tant que TRemoteResource et lire ses données. Voir Lecture d'une ressource distante entrante.
• Lorsqu'une ressource distante qui encapsule un flux change, l'événement OnResourceUpdated se produit, mais la valeur de l'instance de TCustomRemoteItem souscrite n'est pas mise à jour. Vous devez demander la nouvelle valeur de la ressource manuellement. Voir Demande de ressources distantes.
• L'événement OnResourceUpdated ne se produit pas si vous souscrivez à la même ressource distance en utilisant une ressource locale.

Exceptions

Un appel à SubscribeToRemoteItem peut déclencher l'une des exceptions suivantes :

Exception	Exception.Message	Scénarios
ETetheringException	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>.	SubscribeToRemoteItem n'a pas pu obtenir une connexion à AProfile.
	Impossible de se connecter au profil <identificateur de profil>	SubscribeToRemoteItem n'a pas pu se connecter à AProfile.

Voir aussi

• System.Tether.Manager.TTetheringProfileInfo
• System.Tether.AppProfile.TCustomRemoteItem

• System.Tether.AppProfile.TTetheringAppProfile.OnResourceUpdated

• System.Tether.AppProfile.TTetheringAppProfile.UnSubscribeFromRemoteItem

• Partage de données avec des applications distantes à l'aide du tethering d'app