ncdengine/inc/ncdnodeinstall.h
branchRCL_3
changeset 25 7333d7932ef7
parent 0 ba25891c3a9e
child 26 8b7f4e561641
equal deleted inserted replaced
24:5cc91383ab1e 25:7333d7932ef7
    30 class MNcdInstallOperation;
    30 class MNcdInstallOperation;
    31 class MNcdInstallOperationObserver;
    31 class MNcdInstallOperationObserver;
    32 class MDesCArray;
    32 class MDesCArray;
    33 class MNcdInstalledContent;
    33 class MNcdInstalledContent;
    34 
    34 
    35 // Forward declaration for SwiUI::TInstallOptions
    35 // Forward declaration for Usif::TInstallOptions
    36 // SwiUI namespace contains install options 
    36 namespace Usif
    37 // that are used for the silent install.
       
    38 // #include <SWInstDefs.h> 
       
    39 // is required when SwiUI::TInstallOptions is created 
       
    40 // in the implementation code.
       
    41 namespace SwiUI
       
    42     {
    37     {
    43     class TInstallOptions;    
    38     class COpaqueNamedParams;    
    44     }
    39     }
    45 
       
    46 
    40 
    47 /**
    41 /**
    48  *  Provides functions that can be used to install the node object.
    42  *  Provides functions that can be used to install the node object.
    49  *  Before installing, the data should have been downloaded using
    43  *  Before installing, the data should have been downloaded using
    50  *  download interface.
    44  *  download interface.
    81      *  Leaves with KNcdErrorParallelOperationNotAllowed if a parallel client is running
    75      *  Leaves with KNcdErrorParallelOperationNotAllowed if a parallel client is running
    82      *  an operation for the same metadata. See MNcdOperation for full explanation.
    76      *  an operation for the same metadata. See MNcdOperation for full explanation.
    83      */
    77      */
    84     virtual MNcdInstallOperation* InstallL( MNcdInstallOperationObserver& aObserver ) = 0;
    78     virtual MNcdInstallOperation* InstallL( MNcdInstallOperationObserver& aObserver ) = 0;
    85 
    79 
    86 
       
    87     /**
    80     /**
    88      * Starts the silent installing operation of the node object.
    81      * Starts the silent installing operation of the node object.
    89      * Because installation is silent, normal installation query dialogs are not shown.
    82      * Because installation is silent, normal installation query dialogs are not shown.
    90      * But, the caller of this function may use aInstallOptions parameter to define that 
    83      * But, the caller of this function may use aInstallOptions parameter to define that 
    91      * text files that are included in SIS packages will be shown in query dialogs during installation.
    84      * text files that are included in SIS packages will be shown in query dialogs during installation.
    94      * 
    87      * 
    95      * @note The reference count of the operation object is increased by one. So, Release()
    88      * @note The reference count of the operation object is increased by one. So, Release()
    96      * function of the operation should be called when operation is not needed anymore.
    89      * function of the operation should be called when operation is not needed anymore.
    97      * 
    90      * 
    98      * @note Requires TrustedUI capabilities
    91      * @note Requires TrustedUI capabilities
    99      * @note Only SIS packages and Java archives are installed silently, other content
    92      * @note Only SIS packages and Java archives and widgets are installed silently, other content
   100      * is installed exactly like with InstallL
    93      * is installed exactly like with InstallL
   101      * 
    94      * 
   102      * @param aObserver Observer for the operation.
    95      * @param aObserver Observer for the operation.
   103      * @param aInstallOptions These install options are used by the silent install.
    96      * @param aInstallOptions These install options are used by the silent install.
   104      * @return The operation that handles the installation. 
    97      * @return The operation that handles the installation. 
   107      * @exception Leave System wide error code.
   100      * @exception Leave System wide error code.
   108      * Leaves with KErrPermissionDenied if UI does not have TrustedUI capability.
   101      * Leaves with KErrPermissionDenied if UI does not have TrustedUI capability.
   109      * Leaves with KNcdErrorParallelOperationNotAllowed if a parallel client is running
   102      * Leaves with KNcdErrorParallelOperationNotAllowed if a parallel client is running
   110      *  an operation for the same metadata. See MNcdOperation for full explanation.
   103      *  an operation for the same metadata. See MNcdOperation for full explanation.
   111      */
   104      */
   112     virtual MNcdInstallOperation* SilentInstallL( MNcdInstallOperationObserver& aObserver,
   105     virtual MNcdInstallOperation* SilentInstallL( 
   113                                                   const SwiUI::TInstallOptions& aInstallOptions ) = 0;
   106                 MNcdInstallOperationObserver& aObserver,
   114 
   107                 Usif::COpaqueNamedParams* aInstallOptions ) = 0;
   115 
   108 
   116     /**
   109     /**
   117      * Checks if the item content has already been installed and is currently present in the
   110      * Checks if the item content has already been installed and is currently present in the
   118      * device.
   111      * device.
   119      *
   112      *