From RAD Studio API Documentation
Jump to: navigation, search


procedure DoLaunchNotification(const AProfileId, ANotification, Data: string); virtual;


virtual void __fastcall DoLaunchNotification(const System::UnicodeString AProfileId, const System::UnicodeString ANotification, const System::UnicodeString Data);


Type Visibility Source Unit Parent
System.Tether.Manager TTetheringAdapter


Handles a notification received from a remote adapter, and passes this notification to the manager of your adapter.

When a remote adapter paired to your adapter sends your adapter a notification, DoLaunchNotification receives this notification and passes the notification data to the manager of your adapter, which relays the notification data to the target profile.

Remote adapters are not meant to send notifications on their own. DoLaunchNotification 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.

DoLaunchNotification receives the following parameters:

  • 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