System.Tether.AppProfile.TTetheringAppProfile.GetRemoteResourceValue
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 */;
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | System.Tether.AppProfile.pas System.Tether.AppProfile.hpp |
System.Tether.AppProfile | TTetheringAppProfile |
Beschreibung
Fordert eine Aktualisierung der angegebenen Remote-Ressource von ihrem Remote-Profil an und gibt die aktualisierte Ressource zurück.
Verwenden Sie zur Angabe einer Remote-Ressource einen der folgenden Parameter:
- Bereitstellen einer Instanz von TRemoteResource (
ARemoteRes
). - Bereitstellen des Remote-Profils, das die Remote-Ressource (
AProfile
) und den Namen der Remote-Ressource (ARemoteResName
) enthält.
Falls ein Fehler beim Analysieren der aktualisierten Daten aus dem Remote-Profil auftritt, gibt GetRemoteResourceValue einen Nullwert zurück.
GetRemoteResourceValue ist eine synchrone Funktion. Diese Funktion führt eine Anforderung an das Remote-Profil aus und die Ausführung der Funktion wird erst nach dem Empfang einer Antwort von dem Remote-Profil beendet. Sie können einen separaten Thread verwenden, um diese Funktion auszuführen.
GetRemoteResourceValue löst möglicherweise eine ETetheringException-Exception in den folgenden Situationen aus:
- Die angegebene Instanz von TRemoteResource (
ARemoteRes
) stimmt mit keinem der bekannten Remote-Profile überein. - Das angegebene Remote-Profil (
AProfile
) stimmt mit keinem der bekannten Remote-Profile überein. - Das angegebene Remote-Profil (
AProfile
) enthält keine Remote-Ressource mit dem angegebenen Namen (ARemoteResName
).