System.Tether.AppProfile.TTetheringAppProfile.SubscribeToRemoteItem
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 | シナリオ |
---|---|---|
プロファイル <プロファイル識別子> は接続されていません。 |
| |
<プロファイル識別子> への接続がありません。 |
| |
プロファイル <プロファイル識別子> への接続を取得できません。 |
| |
プロファイル <プロファイル識別子> に接続できません。 |
|