System.Tether.AppProfile.TTetheringAppProfile.GetRemoteResourceValue

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

プロパティ

種類	可視性	ソース	ユニット	親
function	public	System.Tether.AppProfile.pas System.Tether.AppProfile.hpp	System.Tether.AppProfile	TTetheringAppProfile

説明

指定されたリモート リソースのリモート プロファイルへの更新をリクエストし、更新されたリソースを返します。

リモート リソースは、次のパラメータのいずれかと共に指定することができます：

• TRemoteResource のインスタンス（ARemoteRes）。
• リモート リソース（AProfile）と、リモート リソースの名前（ARemoteResName）を保有するリモート プロファイル。

更新されたデータをリモート プロファイルから解析するのに問題があった場合、GetRemoteResourceValue は、null 値を返します。

GetRemoteResourceValue は、同期関数です。この関数は、リモート プロファイルへのリクエストを実行し、その関数の実行は、リモート プロファイルからレスポンスがあったときにのみ終了します。この関数を実行するのに、個別のスレッドを使用する方がいい場合もあるでしょう。

例外

GetRemoteResourceValue への呼び出しは、次の例外のいずれかを発生させます：

Exception	Exception.Message	シナリオ
ETetheringException	リソース <リソース名> のプロファイルが見つかりません	指定された TRemoteResource のインスタンス（ARemoteRes）が、どの既知のリモート プロファイルとも一致しない。
	リモート リソースが見つかりません	指定されたリモート プロファイル（AProfile）が、どのリモート リソースも含んでいません。 指定されたリモート プロファイル（AProfile）が、指定された名前（ARemoteResName）を持つリモート リソースを含んでいない。
	<プロファイル識別子> への接続がありません。	リモート リソースのリモート プロファイルに、許可された接続がありません。
	プロファイル <プロファイル識別子> へ接続できません。	GetRemoteResourceValue がリモート リソースのリモート プロファイルへ接続できません。

関連項目

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

• System.Tether.AppProfile.TTetheringAppProfile.Connect

• マルチスレッド アプリケーションの作成

• System.Tether.AppProfile.TTetheringAppProfile.RunRemoteAction