System.Tether.AppProfile.TTetheringAppProfile.RunRemoteAction

• Übergeordnet: 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 */;

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	System.Tether.AppProfile.pas System.Tether.AppProfile.hpp	System.Tether.AppProfile	TTetheringAppProfile

Beschreibung

Fordert die Ausführung der angegebenen Remote-Aktion an und gibt True zurück, wenn die Ausführung erfolgreich ist und False, wenn ein Fehler aufgetreten ist.

Sie können eine Remote-Aktion mit einem der folgenden Parameter festlegen:

• Bereitstellen einer Instanz von TRemoteAction (AnAction).
• Bereitstellen des Remote-Profils, das die Remote-Aktion enthält (AProfile) und des Namens der Remote-Aktion (AnActionName).

RunRemoteAction gibt False zurück, wenn einer der folgenden Fehler auftritt:

• Das Remote-Profil hat keine Aktion mit dem Namen der angeforderten Aktion veröffentlicht.
• Der Befehl, den RunRemoteAction an das Remote-Profil gesendet hat, war ungültig.

Hinweis: RunRemoteAction führt vor dem Senden einer Ausführungsanforderung an ein Remote-Profil clientseitige Prüfungen durch. Daher ist das Auftreten dieser Fehler eher unwahrscheinlich.

RunRemoteAction ist eine synchrone Funktion. Diese Funktion führt eine Anforderung an das Remote-Profil durch, und die Funktion wird erst nach einer Antwort vom Remote-Profil beendet. Sie sollten die Methode RunRemoteActionAsync ausführen.

Exceptions

Ein Aufruf von RunRemoteAction könnte eine der folgenden Exceptions auslösen:

Exception	Exception.Message	Szenarien
ETetheringException	Profil für Aktion <Aktionname> wurde nicht gefunden	Die angegebene Instanz von TRemoteAction (AnAction) stimmt mit keinem bekannten Remote-Profil überein. Das angegebene Remote-Profil (AProfile) enthält keine Remote-Aktion. Das angegebene Remote-Profil (AProfile) enthält keine Remote-Aktion mit dem angegebenen Namen (AnActionName).
	Keine verfügbaren Verbindungen zu <Profilidentifikation>	Das Remote-Profil der Remote-Aktion hat keine zugelassene Verbindung.
	Verbindung mit Profil <Profilidentifikation> nicht möglich	RunRemoteAction konnte die Verbindung zum Remote-Profil der Remote-Aktion nicht herstellen.

Siehe auch

• 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

• Multithread-Anwendungen entwickeln

• System.Tether.AppProfile.TTetheringAppProfile.GetRemoteResourceValue

• MediaPlayer (Beispiel)