DISTRIBUTED COMPUTING - Getting details of an Elan License Manager license key

Getting details of an Elan License Manager license key

ELFIN inherits the Elan License Manager notion of providing details about the license activation keys installed on the Elan License Manager licensing server. ELFIN allows the developer to access this detail information via another provider-specific TProviderOperation derived class: TElfinLicenseData.

  class TElfinLicenseData : public TProviderOperation {
  //    Copyright (C) 1995 Taligent, Inc. All rights reserved.
  public:
      //................................................................
      //    Constructors and destructor
                          TElfinLicenseData();
      virtual             ~TElfinLicenseData();
      
      //................................................................
      //    operator overloads.
      TElfinLicenseData&  operator=   (const TElfinLicenseData&);
  
      //................................................................
      //    MCollectible overrides.
      TStream&            operator>>=(TStream& toWhere) const;
      TStream&            operator<<= (TStream& fromWhere);
  
      //................................................................
      //    Required TProviderOperation overrides.
      virtual void        GetOperationType(TStandardText& token) const;
  
      //................................................................
      //  Data available from elm_getinfo().
      const TText&        GetAlias() const;
      const TText&        GetVendorData() const;
      const TTime&        GetStartsOn() const;
      const TTime&        GetExpiresOn() const;
      const TTime&        GetInstalledOn() const;
      const TLicenseUnit& GetTotalUnits() const;
      const TLicenseUnit& GetSoftTotalUnits() const;
      const TLicenseUnit& GetTotalReserved() const;
      const TLicenseUnit& GetUsedFromReservePool() const;
      const TLicenseUnit& GetOtherUsed() const;
      const TLicenseUnit& GetAvailableToMe() const;
      Boolean             GetNodeLocked() const;
      Boolean             GetResourceAttached() const;
      char                GetDomain() const;
      signed long         GetStatus() const;
  
  protected:
  };

Instantiation

TElfinLicenseData allows allocation on the heap or the stack. If an object of this class is added into the collection supplied to the GetOperations function of the licensed product's TLicenseUse derived class, the object should be allocated on the heap. Alternatively, the object can be passed to ExecuteOperations, in which case the caller is responsible for the allocation location.

Member functions

GetOperationType returns the identifying information for the class. The passed token should be filled in so that it is equal to kElfinGetLicenseDataOperationType.

GetStatus returns the status returned by the underlying Elan License Manager code. If the returned status is less than zero, all other Elan License Manager information available from the object should be considered invalid.

Accessors for Elan License Manager information

The following Getters provide access to the underlying Elan License Manager information associated with a license activation key. For more detailed information about the semantics of this information, see the Elan License Manager documentation provided with the Elan License Manager ADK.

GetAlias returns the Elan License Manager alias for the feature associated with the license key.
GetVendorData returns the vendor data: an arbitrary string associated with the key. This data is often used to control access to subparts of the licensed product.
GetStartsOn returns the first date for which the key is valid.
GetExpiresOn returns the date after which the key becomes invalid.
GetInstalledOn returns the date on which the key was installed at the end-user site.
GetTotalUnits returns the total number of licensing units associated with the key.
GetSoftTotalUnits returns the total number of soft units: after this many units have been allocated, the licensing server records the event in its log to alert the site administrator to the possible need for purchasing more units.
GetTotalReserved returns the total number of reserved units. The site administrator can reserve some or all of the units for particular groups or individuals in the Elan License Manager resource file.
GetUsedFromReservePool returns the number of licensing units allocated from the reserved units.
GetOtherUsed returns the number of licensing units allocated from those units not reserved. Thus the sum of GetTotalReserveUsed and GetOtherUsed is the total number of allocated units of any category.
GetAvailableToMe returns the number of units available for allocation to the caller. It may be 0 even though unallocated units exist because the caller might be restricted from using the reserved units.
GetNodeLocked returns True if and only if the license key is locked to using a specific host.
GetResourceAttached returns True if and only if the key specifies an attached resource file. See the Elan License Manager ADK for details.
GetDomain returns one of `A', `B' or `C' dependent on the type of the network domain associated with the key. Only clients in the same domain as the licensing server for the domain type of the key are granted units from the key. If no domain is specified, the domain type might be null.

Deriving Classes

TElfinLicenseData is not designed for derivation.

Concurrency

TElfinLicenseData is not designed for concurrent access.

[Contents] [Previous] [Next]

Click the icon to mail questions or corrections about this material to Taligent personnel.

Generated with WebMaker