TProviderOperation

  class TProviderOperation : public MCollectible {
  //    Copyright (C) 1995 Taligent, Inc. All rights reserved.
  public:
      //.................................................................
      //  destructor
      virtual             ~TProviderOperation();
      
      //.................................................................
      //  MCollectible overrides.
      TStream&            operator>>=(TStream& toWhere) const;
      TStream&            operator<<= (TStream& fromWhere);
      
      //.................................................................
      //  TProviderOperation specific operations.
      virtual void        GetOperationType(TText& textBuffer)const = 0;
          
      //.................................................................
      //  Getter and setter for exceptions.
      const TLicenseException *
                          GetException() const;
      virtual void        SetException(const TLicenseException& except;
          
  protected:
  };

Member functions

SetException allows a provider to associate a license exception with a provider operation. Typically, the provider streams the set of provider operations to its licensing server. If the licensing server catches an exception while processing an element of that set, it can use SetException to store a provider-specific exception object with the failed operation object. The TLicenseException derived class must map any exception thrown during the processing of the provider operation object into the licensing domain. In some cases, it might be appropriate for the provider's TLicenseException derived class to act simply as an "envelope" for the originally thrown exception.

After the provider operation set is streamed back to the provider's framework implementation from its licensing server, the implementation can use GetException to examine the exception and decide whether it warrants causing the composite licensing request to fail. If the provider's framework implementation leaves the exception stored with the provider operation, the licensed product can inspect the exception in its AcceptOperationsResults function (or at the call site of ExecuteOperations).

GetException is used to inspect an exception stored with a provider operation object. The return value is an alias for the private storage belonging to the provider operation object; therefore, the lifetime of the returned value is no longer than the lifetime of the provider operation, and is even shorter if SetException is called.

Deriving classes

Concurrency

Resource use