installationservices/swinstallationfw/inc/sifnotification.h
changeset 60 245df5276b97
parent 53 ae54820ef82c
child 75 2d2d25361590
equal deleted inserted replaced
53:ae54820ef82c 60:245df5276b97
    75      */ 
    75      */ 
    76     IMPORT_C static CSifOperationStartData* NewL(RReadStream& aStream);
    76     IMPORT_C static CSifOperationStartData* NewL(RReadStream& aStream);
    77     
    77     
    78     /**
    78     /**
    79         Creates a CSifOperationStartData object.
    79         Creates a CSifOperationStartData object.
       
    80 
       
    81 		@deprecated  Use the overload with aOperationPhase instead.
    80         
    82         
    81         @param  aGlobalComponentId  The global component id which uniquely identifies the operation          
    83         @param  aGlobalComponentId  The global component id which uniquely identifies the operation          
    82         @param  aComponentName		The name of the software component
    84         @param  aComponentName		The name of the software component
    83         @param  aApplicationNames	The list of applications associated with the software component, an empty array in case of no applications
    85         @param  aApplicationNames	The list of applications associated with the software component, an empty array in case of no applications
    84         @param  aApplicationIcons   The list of corresponding application icon names(without path) for every application, an empty array in case of no applications                 
    86         @param  aApplicationIcons   The list of corresponding application icon names(without path) for every application, an empty array in case of no applications                 
    88         @param  aSoftwareType		The software type name of the software component
    90         @param  aSoftwareType		The software type name of the software component
    89                                                    
    91                                                    
    90         @return A pointer to the newly allocated CSifOperationStartData object, if creation is successful.
    92         @return A pointer to the newly allocated CSifOperationStartData object, if creation is successful.
    91      */      
    93      */      
    92     IMPORT_C static CSifOperationStartData* NewL(const TDesC& aGlobalComponentId, const TDesC& aComponentName, const RPointerArray<HBufC>& aApplicationNames,
    94     IMPORT_C static CSifOperationStartData* NewL(const TDesC& aGlobalComponentId, const TDesC& aComponentName, const RPointerArray<HBufC>& aApplicationNames,
    93                                                   const RPointerArray<HBufC>& aApplicationIcons, TInt aComponentSize, const TDesC& aIconPath, const TDesC& aComponentIcon, const TDesC& aSoftwareType);
    95                                                   const RPointerArray<HBufC>& aApplicationIcons, TInt aComponentSize, const TDesC& aIconPath, const TDesC& aComponentIcon, 
    94 
    96                                                       const TDesC& aSoftwareType);
       
    97     
    95     /**
    98     /**
    96         Creates a CSifOperationStartData object.
    99         Creates a CSifOperationStartData object.
    97         
   100         
    98         @param  aGlobalComponentId  The global component id which uniquely identifies the operation          
   101         @param  aGlobalComponentId  The global component id which uniquely identifies the operation          
    99         @param  aComponentName      The name of the software component
   102         @param  aComponentName      The name of the software component
   101         @param  aApplicationIcons   The list of corresponding application icon names(without path) for every application, an empty array in case of no applications                 
   104         @param  aApplicationIcons   The list of corresponding application icon names(without path) for every application, an empty array in case of no applications                 
   102         @param  aComponentSize      The total size of the component in bytes
   105         @param  aComponentSize      The total size of the component in bytes
   103         @param  aIconPath           The path where all application and component icons are found
   106         @param  aIconPath           The path where all application and component icons are found
   104         @param  aComponentIcon      The name of the component icon(without path)
   107         @param  aComponentIcon      The name of the component icon(without path)
   105         @param  aSoftwareType       The software type name of the software component
   108         @param  aSoftwareType       The software type name of the software component
       
   109         @param  aOperationPhase     The type of SIF operation
   106                                                    
   110                                                    
   107         @return A pointer to the newly allocated CSifOperationStartData object, if creation is successful.
   111         @return A pointer to the newly allocated CSifOperationStartData object, if creation is successful.
       
   112      */      
       
   113     IMPORT_C static CSifOperationStartData* NewL(const TDesC& aGlobalComponentId, const TDesC& aComponentName, const RPointerArray<HBufC>& aApplicationNames,
       
   114                                                   const RPointerArray<HBufC>& aApplicationIcons, TInt aComponentSize, const TDesC& aIconPath, const TDesC& aComponentIcon, 
       
   115                                                       const TDesC& aSoftwareType, TSifOperationPhase aOperationPhase);
       
   116 
       
   117     /**
       
   118         Creates a CSifOperationStartData object.
       
   119 
       
   120   		@deprecated  Use the overload with aOperationPhase instead.
       
   121         
       
   122         @param  aGlobalComponentId  The global component id which uniquely identifies the operation          
       
   123         @param  aComponentName      The name of the software component
       
   124         @param  aApplicationNames   The list of applications associated with the software component, an empty array in case of no applications
       
   125         @param  aApplicationIcons   The list of corresponding application icon names(without path) for every application, an empty array in case of no applications                 
       
   126         @param  aComponentSize      The total size of the component in bytes
       
   127         @param  aIconPath           The path where all application and component icons are found
       
   128         @param  aComponentIcon      The name of the component icon(without path)
       
   129         @param  aSoftwareType       The software type name of the software component
       
   130                                                            
       
   131         @return A pointer to the newly allocated CSifOperationStartData object, if creation is successful.
   108                 The pointer is also put onto the cleanup stack. 
   132                 The pointer is also put onto the cleanup stack. 
   109      */     
   133      */     
   110     IMPORT_C static CSifOperationStartData* NewLC(const TDesC& aGlobalComponentId, const TDesC& aComponentName, const RPointerArray<HBufC>& aApplicationNames,
   134     IMPORT_C static CSifOperationStartData* NewLC(const TDesC& aGlobalComponentId, const TDesC& aComponentName, const RPointerArray<HBufC>& aApplicationNames,
   111                                                   const RPointerArray<HBufC>& aApplicationIcons, TInt aComponentSize, const TDesC& aIconPath, const TDesC& aComponentIcon, const TDesC& aSoftwareType);
   135                                                       const RPointerArray<HBufC>& aApplicationIcons, TInt aComponentSize, const TDesC& aIconPath, const TDesC& aComponentIcon, 
       
   136                                                           const TDesC& aSoftwareType);
       
   137     
       
   138 
       
   139     /**
       
   140         Creates a CSifOperationStartData object.
       
   141         
       
   142         @param  aGlobalComponentId  The global component id which uniquely identifies the operation          
       
   143         @param  aComponentName      The name of the software component
       
   144         @param  aApplicationNames   The list of applications associated with the software component, an empty array in case of no applications
       
   145         @param  aApplicationIcons   The list of corresponding application icon names(without path) for every application, an empty array in case of no applications                 
       
   146         @param  aComponentSize      The total size of the component in bytes
       
   147         @param  aIconPath           The path where all application and component icons are found
       
   148         @param  aComponentIcon      The name of the component icon(without path)
       
   149         @param  aSoftwareType       The software type name of the software component
       
   150         @param  aOperationPhase     The type of SIF operation
       
   151                                                            
       
   152         @return A pointer to the newly allocated CSifOperationStartData object, if creation is successful.
       
   153                 The pointer is also put onto the cleanup stack. 
       
   154      */     
       
   155     IMPORT_C static CSifOperationStartData* NewLC(const TDesC& aGlobalComponentId, const TDesC& aComponentName, const RPointerArray<HBufC>& aApplicationNames,
       
   156                                                       const RPointerArray<HBufC>& aApplicationIcons, TInt aComponentSize, const TDesC& aIconPath, const TDesC& aComponentIcon, 
       
   157                                                           const TDesC& aSoftwareType, TSifOperationPhase aOperationPhase);
   112     
   158     
   113     /**
   159     /**
   114      @return The global component Id associated with the operation.
   160      @return The global component Id associated with the operation.
   115      */     
   161      */     
   116     IMPORT_C const HBufC& GlobalComponentId() const;
   162     IMPORT_C const HBufC& GlobalComponentId() const;
   151     IMPORT_C const HBufC& SoftwareType() const;    
   197     IMPORT_C const HBufC& SoftwareType() const;    
   152     
   198     
   153     IMPORT_C ~CSifOperationStartData();          
   199     IMPORT_C ~CSifOperationStartData();          
   154 
   200 
   155     IMPORT_C void ExternalizeL(RWriteStream& aStream) const;
   201     IMPORT_C void ExternalizeL(RWriteStream& aStream) const;
       
   202     
       
   203     /**
       
   204      @return The type of SIF operation.
       
   205      */   
       
   206     IMPORT_C TSifOperationPhase OperationPhase() const;
   156 
   207 
   157 private:
   208 private:
   158     CSifOperationStartData();
   209     CSifOperationStartData();
   159     void ConstructL(const TDesC& aGlobalComponentId, const TDesC& aComponentName, const RPointerArray<HBufC>& aApplicationNames,  
   210     void ConstructL(const TDesC& aGlobalComponentId, const TDesC& aComponentName, const RPointerArray<HBufC>& aApplicationNames,  
   160           const RPointerArray<HBufC>& aApplicationIcons, TInt aComponentSize, const TDesC& aIconPath, const TDesC& aComponentIcon, const TDesC& aSoftwareType);
   211                         const RPointerArray<HBufC>& aApplicationIcons, TInt aComponentSize, const TDesC& aIconPath, 
       
   212                             const TDesC& aComponentIcon, const TDesC& aSoftwareType, TSifOperationPhase aOperationPhase);
   161     void InternalizeL(RReadStream& aStream);
   213     void InternalizeL(RReadStream& aStream);
   162 
   214 
   163 private:
   215 private:
   164     HBufC* iGlobalComponentId;                                    
   216     HBufC* iGlobalComponentId;                                    
   165     HBufC* iComponentName;
   217     HBufC* iComponentName;
   168     RPointerArray<HBufC> iApplicationIcons;          
   220     RPointerArray<HBufC> iApplicationIcons;          
   169     TInt iComponentSize;
   221     TInt iComponentSize;
   170     HBufC* iIconPath;      
   222     HBufC* iIconPath;      
   171     HBufC* iSoftwareType;
   223     HBufC* iSoftwareType;
   172     TSifOperation iOperationType;
   224     TSifOperation iOperationType;
       
   225     TSifOperationPhase iOperationPhase;
   173     };
   226     };
   174 
   227 
   175 
   228 
   176 /*
   229 /*
   177  * This contains the error status information after an install/uninstall operation
   230  * This contains the error status information after an install/uninstall operation
   314      */    
   367      */    
   315     IMPORT_C TSifOperationSubPhase SubPhase() const;
   368     IMPORT_C TSifOperationSubPhase SubPhase() const;
   316     
   369     
   317     /**
   370     /**
   318      @return The current progress value.
   371      @return The current progress value.
       
   372 
       
   373 	 @deprecated  Use CurrentProgress() instead.
   319      */     
   374      */     
   320     IMPORT_C TInt CurrentProgess() const;
   375     IMPORT_C TInt CurrentProgess() const;
       
   376     
       
   377     /**
       
   378      @return The current progress value.
       
   379      */     
       
   380     IMPORT_C TInt CurrentProgress() const;
   321     
   381     
   322     /**
   382     /**
   323      @return The total value to achieve completion of the subphase.
   383      @return The total value to achieve completion of the subphase.
   324      */     
   384      */     
   325     IMPORT_C TInt Total() const;  
   385     IMPORT_C TInt Total() const;