System.Tether.Manager.TTetheringManager.SendNotification

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

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