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