System.Tether.AppProfile.TTetheringAppProfile.GetRemoteResourceValue

• Aller au parent : TTetheringAppProfile

Delphi

function GetRemoteResourceValue(const ARemoteRes: TRemoteResource): TRemoteResource; overload;
function GetRemoteResourceValue(const AProfile: TTetheringProfileInfo; const ARemoteResName: string): TRemoteResource; overload;

C++

TRemoteResource* __fastcall GetRemoteResourceValue(TRemoteResource* const ARemoteRes)/* overload */;
TRemoteResource* __fastcall GetRemoteResourceValue(const System::Tether::Manager::TTetheringProfileInfo &AProfile, const System::UnicodeString ARemoteResName)/* overload */;

Propriétés

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

Description

Requiert une mise à jour de la ressource distante spécifiée à son profil distant et renvoie la ressource mise à jour.

Vous pouvez spécifier une ressource distante avec l'un des paramètres suivants :

• Fournissez une instance de TRemoteResource (ARemoteRes).
• Fournissez le profil distant qui contient la ressource distante (AProfile) et le nom de la ressource distante (ARemoteResName).

S'il existe un problème avec l'analyse des données mises à jour à partir du profil distant, GetRemoteResourceValue renvoie une valeur null.

GetRemoteResourceValue est une fonction synchrone. Cette fonction effectue une requête au profil distant et l'exécution de la fonction se termine uniquement après la réception d'une réponse à partir du profil distant. Vous pouvez utiliser un thread séparé pour exécuter cette fonction.

Exceptions

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

Exception	Exception.Message	Scénarios
ETetheringException	Impossible de trouver le profil pour le <nom de la ressource>	L'instance spécifiée de TRemoteResource (ARemoteRes) ne correspond à aucun profil distant connu.
	Ressource distante pas trouvée	Le profil distant spécifié (AProfile) ne contient aucune ressource distante. Le profil distant spécifié (AProfile) ne contient aucune ressource distante avec le nom spécifié (ARemoteResName).
	Aucune connexion disponible pour <l'identificateur de profil>	Le profil distant de la ressource distante ne comporte aucune connexion permise.
	Impossible de se connecter à <l'identificateur de profil>	GetRemoteResourceValue ne peut pas se connecter au profil distant de la ressource distante.

Voir aussi

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

• System.Tether.AppProfile.TTetheringAppProfile.Connect

• Ecriture d'applications multithread

• System.Tether.AppProfile.TTetheringAppProfile.RunRemoteAction