System.Tether.AppProfile.TTetheringAppProfile.SubscribeToRemoteItem

• Übergeordnet: TTetheringAppProfile

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 */;

Eigenschaften

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

Beschreibung

Abonniert dieses Anwendungsprofil für die angegebene Remote-Ressource des angegebenen Remote-Profils für Aktualisierungen.

Sie können eine Remote-Ressource zum Abonnieren mit einer der folgenden Parametergruppen festlegen:

• Bereitstellen des Remote-Anwendungsprofils, das die Remote-Ressource als Instanz von TTetheringProfileInfo enthält, und des Namens der Remote-Ressource.

Die Eigenschaft RemoteProfiles der TTetheringManager-Komponente stellt eine Liste der Remote-Anwendungsprofile bereit, die mit Ihrem Profil verbunden sind.

• Bereitstellen des Remote-Anwendungsprofils, das die Remote-Ressource als Instanz von TTetheringProfileInfo und als Instanz von TCustomRemoteItem enthält.

Die TTetheringAppProfile-Komponente stellt eine Methode bereit, GetRemoteProfileActions, die eine Liste der Remote-Ressourcen zurückgibt, die von einem gegebenen, als Instanz von TTetheringProfileInfo festgelegten Remote-Anwendungsprofil geteilt werden.

Wenn sich der Wert einer Remote-Ressource mit demselben Namen wie die Instanz von TCustomRemoteItem, die Sie abonniert haben, ändert, wird der Wert der abonnierten Instanz von TCustomRemoteItem aktualisiert und das Ereignis OnResourceUpdated ausgelöst.

Hinweise:

• Um den Wert aus der abonnierten Instanz von TCustomRemoteItem zu lesen, müssen Sie den Typ dieser Instanz in TRemoteResource umwandeln und die Daten lesen. Siehe Lesen einer eingehenden Remote-Ressource.
• Wenn sich eine Remote-Ressource, die einen Stream kapselt, ändert, wird das Ereignis OnResourceUpdated ausgelöst, aber der Wert der abonnierten Instanz von TCustomRemoteItem wird nicht aktualisiert. Sie müssen den neuen Ressourcenwert manuell anfordern. Siehe Anfordern von Remote-Ressourcen.
• Das Ereignis OnResourceUpdated wird nicht ausgelöst, wenn Sie dieselbe Ressource mit einer lokalen Ressource abonnieren.

Exceptions

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

Exception	Exception.Message	Szenarien
ETetheringException	Profil <Profilbezeichner> ist nicht verbunden.	AProfile ist nicht verbunden.
	Keine verfügbaren Verbindungen zu <Profilbezeichner>	AProfile hat keine zugelassene Verbindung.
	Verbindung zum Profil <Profilbezeichner> kann nicht hergestellt werden.	SubscribeToRemoteItem konnte keine Verbindung zu AProfile herstellen.
	Verbindung zum Profil <Profilbezeichner> kann nicht hergestellt werden.	SubscribeToRemoteItem konnte die Verbindung mit AProfile nicht herstellen.

Siehe auch

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

• System.Tether.AppProfile.TTetheringAppProfile.OnResourceUpdated

• System.Tether.AppProfile.TTetheringAppProfile.UnSubscribeFromRemoteItem

• Teilen von Daten mit Remote-Anwendungen mithilfe von App-Tethering