System.Tether.Manager.TTetheringManager.SendNotification

From Appmethod Libraries
Jump to: navigation, search

Object Pascal

procedure SendNotification(const AManagerId, AProfileId, ANotification, Data: string);

C++

void __fastcall SendNotification(const System::UnicodeString AManagerId, const System::UnicodeString AProfileId, const System::UnicodeString ANotification, const System::UnicodeString Data);

Properties

Type Visibility Source Unit Parent
procedure
function
public
System.Tether.Manager.pas
System.Tether.Manager.hpp
System.Tether.Manager TTetheringManager

Description

Sends the specified notification to the specified remote profile.

Remote managers are not meant to send notifications on their own. SendNotification is part of a chain that goes from one profile to a second profile:

  1. A profile calls SendNotification on its manager, specifying a target remote manager, a target remote profile, a type of notification and a notification.
    The TTetheringAppProfile class, for example, calls SendNotification from some of its methods, such as SendString or NotifyProfileUpdate.
  2. The manager calls SendNotification on the adapter that handles the connection to the specified target remote manager.
  3. The adapter sends the target and notification data to the remote adapter that handles the connection to the specified target remote manager.
  4. The DoLaunchNotification procedure of the remote adapter receives the target and notification data and calls passes this data to its manager.
  5. The remote manager calls Notify on the target profile.
  6. The remote profile handles the notification.

SendNotification receives the following parameters:

  • <AManagerId> is the identifier of the manager that publishes the profile that must receive the notification.
  • <AProfileId> is the identifier of the profile that must receive the notification.
  • <ANotification> is a string that identifies the type of the notification.
  • <Data> is a string that contains an array of values, encoded as strings separated by #*#. For example: Value1#*#Value2.

See Also