System.Tether.Manager.TTetheringManager.Identifier

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

property Identifier: string read FIdentifier;

C++

__property System::UnicodeString Identifier = {read=FIdentifier};

Properties

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

Description

Random string that uniquely identifies your manager.

Identifier is a random GUID generated by TGUID.NewGuid.ToString.

When two managers pair with each other, each manager saves in memory the identifier of the other manager, as well as the hash that both managers used for authentication during the pairing operation. If these managers loose the connection to each other and they discover each other again during the same session when they paired, these managers can recognize each other by their Identifier, and reestablish their connection automatically. See PairManager.

Each time that you instantiate a manager, Identifier is assigned a random string. As a result, when you restart your application, remote managers that previously paired with your manager do not recognize your manager anymore. If you want to persist the Identifier of your manager, you must implement a subclass of TTetheringCustomStorage and assign an instance of this subclass to the AStorage parameter of the OnRequestStorage event of your manager.

See Also