System.Tether.AppProfile.TTetheringAppProfile.RunRemoteActionAsync

• Up to Parent: TTetheringAppProfile

Delphi

function RunRemoteActionAsync(const AnAction: TRemoteAction): TRemoteActionHandle; overload;
function RunRemoteActionAsync(const AProfile: TTetheringProfileInfo; const AnActionName: string): TRemoteActionHandle; overload;

C++

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

Properties

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

Description

Requests the execution of the specified remote action asynchronously and returns an asynchronous remote handle.

You can specify a remote action with either of the following parameters:

• Provide an instance of TRemoteAction (AnAction).
• Provide the remote profile that contains the remote action (AProfile) and the name of the remote action (AnActionName).

RunRemoteActionAsync is an asynchronous function. This function performs a request to the remote profile; when the remote action finishes, the OnASyncRemoteActionEnd event is triggered.

Exceptions

A call to RunRemoteActionAsync may raise the following exception:

Exception	Exception.Message	Scenarios
ETetheringException	Can't find profile for action <action name>	The specified instance of TRemoteAction (AnAction) does not match any known remote profile. The specified remote profile (AProfile) does not contain any remote action. The specified remote profile (AProfile) does not contain any remote action with the specified name (AnActionName).

See Also

• System.Tether.AppProfile.TTetheringAppProfile.GetRemoteActionAsyncState
• System.Tether.AppProfile.TTetheringAppProfile.OnASyncRemoteActionEnd
• System.Tether.AppProfile.TRemoteAction
• System.Tether.AppProfile.TCustomRemoteItem.Name
• System.Tether.Manager.TTetheringProfileInfo
• System.Tether.AppProfile.TTetheringAppProfile.RunRemoteAction
• Writing Multi-threaded Applications