System.Tether.AppProfile.TTetheringAppProfile.SubscribeToRemoteItem

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

function SubscribeToRemoteItem(const AProfile: TTetheringProfileInfo; const ARemoteItem: TCustomRemoteItem): Boolean; overload;
function SubscribeToRemoteItem(const AProfile: TTetheringProfileInfo; const ARemoteItemName: string): Boolean; overload;

C++

bool __fastcall SubscribeToRemoteItem(const System::Tether::Manager::TTetheringProfileInfo &AProfile, TCustomRemoteItem* const ARemoteItem)/* overload */;
bool __fastcall SubscribeToRemoteItem(const System::Tether::Manager::TTetheringProfileInfo &AProfile, const System::UnicodeString ARemoteItemName)/* overload */;

プロパティ

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


説明

このアプリケーション プロファイルで、更新を目的として、指定のリモート プロファイルの指定のリモート リソースをサブスクライブするようにします。

どのリモート リソースをサブスクライブするかは、次のどちらかのパラメータ セットで指定することができます。

  • 目的のリモート リソースが含まれているリモート アプリケーション プロファイルを TTetheringProfileInfo のインスタンスとして指定するほか、そのリモート リソースの名前も指定します。
TTetheringManager コンポーネントの RemoteProfiles プロパティは、お使いのプロファイルに接続されているリモート アプリケーション プロファイルのリストを示します。
  • 目的のリモート リソースが含まれているリモート アプリケーション プロファイルを TTetheringProfileInfo のインスタンスとして指定するほか、TCustomRemoteItem のインスタンスも指定します。
TTetheringAppProfile コンポーネントには GetRemoteProfileActions というメソッドが用意されています。このメソッドは、TTetheringProfileInfo のインスタンスとして指定されたリモート アプリケーション プロファイルで共有されているリモート リソースのリストを返します。

サブスクライブした TCustomRemoteItem インスタンスと同じ名前のリモート リソースの値が変化すると、サブスクライブした TCustomRemoteItem インスタンスの値が更新され、OnResourceUpdated イベントが発生します。

メモ:

  • サブスクライブした TCustomRemoteItem インスタンスから値を読み取るには、このインスタンスを TRemoteResource にキャストして、そのデータを読み取る必要があります。「受信したリモート リソースを読み取る」を参照してください。
  • ストリームをラップしているリモート リソースが変化すると、OnResourceUpdated イベントは発生しますが、サブスクライブした TCustomRemoteItem インスタンスの値は更新されません。新しいリソース値を手動で要求する必要があります。「リモート リソースを要求する」を参照してください。
  • ローカル リソースを使って同じリモート リソースをサブスクライブする場合は、OnResourceUpdated イベントは発生しません。

例外

SubscribeToRemoteItem を呼び出すと、次の例外が発生する可能性があります。

例外 Exception.Message シナリオ

ETetheringException

プロファイル <プロファイル識別子> は接続されていません。

  • AProfile は接続されていません。

<プロファイル識別子> への接続がありません。

プロファイル <プロファイル識別子> への接続を取得できません。

プロファイル <プロファイル識別子> に接続できません。

関連項目