TLicenseProvider

  class TLicenseProvider : public MCollectible, public MReferenceCounted {
  //    Copyright (C) 1995 Taligent, Inc. All rights reserved.
  public:
      //.................................................................
      //  destructor
      virtual         ~TLicenseProvider();
      
      //.................................................................
      //  MCollectible overrides.
      virtual Boolean IsEqual         (const MCollectible*) const;
      virtual TStream&operator>>=   (TStream& toWhere) const;
      virtual TStream&operator<<=     (TStream& fromWhere);
      
      //.................................................................
      //  TLicenseProvider specific operations.
      virtual void    GetProviderProduct(TLicenseProduct&
                                      theProviderProduct) const;
      virtual TLicenseProviderSession*
                      CreateSession   (const TLicenseProduct& prod) = 0;
      static void     GetProviderIterator(TDeleterFor<TIteratorOver<
                                      TLicenseProvider> >& iterator);
      void            FlattenForDistribution(TStream& stream) const;
      void            FlattenForDistribution(const TPathName& pathName)
                                                      const;
      
  protected:
      //.................................................................
      //  Constructors and restricted operations for abstract class.
                          TLicenseProvider();
                          TLicenseProvider(const TLicenseProduct&);
  
  };

Member functions

CreateSession is a pure virtual function that is called by the Licensing framework to create a TLicenseProviderSession derived class object to communicate with this license provider. Each license provider derived class is required to provide an implementation for this function. The implementation should create a dynamically allocated instance of its corresponding TLicenseProviderSession derived class. The Licensing framework adopts the object and assumes responsibility for the storage.

CreateSession is supplied by TLicenseProduct& identifying the licensed product that initiated the TLicenseUse::Check. This identification information is eventually used by the provider's session to look up the activation key on the provider's licensing server.

GetProviderIterator gets an iterator object that can be used to traverse the collection of TLicenseProvider objects. The collection is maintained in a TCollectionOf derivative that is an unordered set.

FlattenForDistribution is used at the development site of the licensing technology provider to create the filed TLicenseProvider object that must be distributed along with the provider's executable shared library. FlattenForDistribution eventually results in the global ::Flatten function being invoked on the object, which in turn calls the streaming function operator >>=.

The overloaded FlattenForDistribution function that takes a TPathName& is usually used. However, in some cases, you might not want to publish this provider by allowing the Licensing framework to place it in the standard location for filed objects; for example, the associated implementation might be unstable. In such a case, the variant that takes a TStream& can be used.

Deriving classes

Concurrency

Resource use