System.Tether.AppProfile.TTetheringAppProfile.RunRemoteAction

• Aller au parent : TTetheringAppProfile

Delphi

function RunRemoteAction(const AnAction: TRemoteAction): Boolean; overload;
function RunRemoteAction(const AProfile: TTetheringProfileInfo; const AnActionName: string): Boolean; overload;

C++

bool __fastcall RunRemoteAction(TRemoteAction* const AnAction)/* overload */;
bool __fastcall RunRemoteAction(const System::Tether::Manager::TTetheringProfileInfo &AProfile, const System::UnicodeString AnActionName)/* overload */;

Propriétés

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

Description

Demande l'exécution de l'action distante spécifiée et renvoie True si l'exécution réussit ou False s'il y a une erreur.

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

• Fournissez une instance de TRemoteAction (AnAction).
• Fournissez le profil distant qui contient l'action distante (AProfile) et le nom de l'action distante (AnActionName).

RunRemoteAction renvoie False si l'une des erreurs suivantes se produit :

• Le profil distant n'a pas publié une action avec le nom de l'action demandée.
• La commande envoyée par RunRemoteAction au profil distant n'était pas invalide.

Remarque : Etant donné que RunRemoteAction effectue des contrôles côté client avant d'envoyer des demandes d'exécution vers un profil distant, la probabilité de ces scénarios est faible.

RunRemoteAction 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, utilisez la méthode RunRemoteActionAsync.

Exceptions

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

Exception	Exception.Message	Scénarios
ETetheringException	Impossible de trouver le profil pour l'action <nom de l'action>	L'instance spécifiée de TRemoteAction (AnAction) ne correspond à aucun profil distant connu. Le profil distant spécifié (AProfile) ne contient aucune action distante. Le profil distant spécifié (AProfile) ne contient aucune action distante avec le nom spécifié (ARemoteResName).
	Aucune connexion disponible pour <l'identificateur de profil>	Le profil distant de l'action distante ne comporte aucune connexion permise.
	Impossible de se connecter au profil <identificateur de profil>	RunRemoteAction n'a pas pu se connecter au profil distant de l'action distante.

Voir aussi

• System.Tether.AppProfile.TRemoteAction
• System.Tether.AppProfile.TCustomRemoteItem.Name
• System.Tether.Manager.TTetheringProfileInfo
• System.Tether.AppProfile.TTetheringAppProfile.RunRemoteActionAsync
• System.Tether.Manager.TTetheringProfile.SendCommand
• System.Tether.AppProfile.TTetheringAppProfile.Connect

• Ecriture d'applications multithread

• System.Tether.AppProfile.TTetheringAppProfile.GetRemoteResourceValue

• Exemple MediaPlayer