cmmanager/cmmgr/cmmserver/inc/cmmdestinationinstance.h
changeset 40 c5b848e6c7d1
parent 30 8dde790cab74
equal deleted inserted replaced
34:3b0cec605979 40:c5b848e6c7d1
    68      * Second phase constructor.
    68      * Second phase constructor.
    69      */
    69      */
    70     void ConstructL();
    70     void ConstructL();
    71 
    71 
    72 public:
    72 public:
    73     void SetId( const TUint32& aId );
    73     void SetId( const TUint32 aId );
    74     TUint32 GetId() const;
    74     TUint32 GetId() const;
    75 
    75 
    76     /**
    76     /**
    77      * Sets a new status value.
    77      * Sets a new status value.
    78      */
    78      */
    89     TInt GetHandle() const;
    89     TInt GetHandle() const;
    90 
    90 
    91     /**
    91     /**
    92      * Set handle ID.
    92      * Set handle ID.
    93      */
    93      */
    94     void SetHandle( const TInt& aHandle );
    94     void SetHandle( const TInt aHandle );
    95 
    95 
    96     /**
    96     /**
    97      * Set the record status for all records.
    97      * Set the record status for all records.
    98      */
    98      */
    99     void SetStatusForAllRecords( const TCmmRecordStatus& aStatus );
    99     void SetStatusForAllRecords( const TCmmRecordStatus& aStatus );
   128     void GetMetadataL(
   128     void GetMetadataL(
   129             const CMManager::TSnapMetadataField& aMetadataField,
   129             const CMManager::TSnapMetadataField& aMetadataField,
   130             TUint32& aMetadata );
   130             TUint32& aMetadata );
   131     void SetMetadataL(
   131     void SetMetadataL(
   132             const CMManager::TSnapMetadataField& aMetadataField,
   132             const CMManager::TSnapMetadataField& aMetadataField,
   133             const TUint32& aMetadata );
   133             const TUint32 aMetadata );
   134 
   134 
   135     void GetProtectionL( CMManager::TProtectionLevel& aProtectionLevel );
   135     void GetProtectionL( CMManager::TProtectionLevel& aProtectionLevel );
   136     void SetProtectionL( CMManager::TProtectionLevel aProtectionLevel );
   136     void SetProtectionL( CMManager::TProtectionLevel aProtectionLevel );
   137 
   137 
   138     /**
   138     /**
   147     CMManager::TProtectionLevel LastProtectionLevel();
   147     CMManager::TProtectionLevel LastProtectionLevel();
   148 
   148 
   149     /**
   149     /**
   150      * Return the protection level currently set into this destination instance.
   150      * Return the protection level currently set into this destination instance.
   151      */
   151      */
   152     CMManager::TProtectionLevel CurrentProtectionLevel();
   152     CMManager::TProtectionLevel CurrentProtectionLevelL();
   153 
   153 
   154     /**
   154     /**
   155      * Adds a connection method into this destination. Returns the index in
   155      * Adds a connection method into this destination. Returns the index in
   156      * the connection method array where the connection method was added.
   156      * the connection method array where the connection method was added.
   157      */
   157      */
   158     TInt AddConnMethodL(
   158     TInt AddConnMethodL(
   159             const CCmmConnMethodInstance& aConnMethodInstance );
   159             CCmmConnMethodInstance& aConnMethodInstance );
   160 
   160 
   161     /**
   161     /**
   162      * Adds an embedded destination into this destination. Returns the index in
   162      * Adds an embedded destination into this destination. Returns the index in
   163      * the connection method array where the connection method was added.
   163      * the connection method array where the connection method was added.
   164      */
   164      */
   179      * method is in use is skipped. This is to avoid a duplicate check, so it
   179      * method is in use is skipped. This is to avoid a duplicate check, so it
   180      * should have been already tested by the caller.
   180      * should have been already tested by the caller.
   181      */
   181      */
   182     void RemoveConnMethodFromDestinationL(
   182     void RemoveConnMethodFromDestinationL(
   183             const CCmmConnMethodInstance& aConnMethodInstance,
   183             const CCmmConnMethodInstance& aConnMethodInstance,
   184             const TBool& aTestIfConnected = ETrue );
   184             const TBool aTestIfConnected = ETrue );
   185 
   185 
   186     /**
   186     /**
   187      * Modifies the priority of a connection method inside this destination.
   187      * Modifies the priority of a connection method inside this destination.
   188      */
   188      */
   189     void ModifyConnMethodPriorityL(
   189     void ModifyConnMethodPriorityL(
   190             const CCmmConnMethodInstance& aConnMethodInstance,
   190             CCmmConnMethodInstance& aConnMethodInstance,
   191             TUint aIndex );
   191             TUint aIndex );
   192 
   192 
   193     /**
   193     /**
   194      * Finds a connection method instance that belongs to the same session and
   194      * Finds a connection method instance that belongs to the same session and
   195      * matches the provided ID. Return NULL if no match is found.
   195      * matches the provided ID. Return NULL if no match is found.
   196      */
   196      */
   197     CCmmConnMethodInstance* FindConnMethodInstanceFromSessionById(
   197     CCmmConnMethodInstance* FindConnMethodInstanceFromSessionById(
   198             const TUint32& aConnMethodId ) const;
   198             const TUint32 aConnMethodId ) const;
   199 
   199 
   200     /**
   200     /**
   201      * Finds a destination instance that belongs to the same session and matches
   201      * Finds a destination instance that belongs to the same session and matches
   202      * the provided ID. Return NULL if no match is found.
   202      * the provided ID. Return NULL if no match is found.
   203      */
   203      */
   204     CCmmDestinationInstance* FindDestinationInstanceFromSessionById(
   204     CCmmDestinationInstance* FindDestinationInstanceFromSessionById(
   205             const TUint32& aDestinationId ) const;
   205             const TUint32 aDestinationId ) const;
   206 
   206 
   207     /**
   207     /**
   208      * Check from all open destination handles in the same session if the given
   208      * Check from all open destination handles in the same session if the given
   209      * connection method is inside any of them. The given destination is
   209      * connection method is inside any of them. The given destination is
   210      * skipped.
   210      * skipped.
   211      */
   211      */
   212     TBool ConnMethodInOtherDestinationInSession(
   212     TBool ConnMethodInOtherDestinationInSession(
   213             const TUint32& aConnMethodId,
   213             const TUint32 aConnMethodId,
   214             const TUint32& aDestinationId ) const;
   214             const TUint32 aDestinationId ) const;
   215 
   215 
   216     /**
   216     /**
   217      * Check if the given connection method is in this destination. Include
   217      * Check if the given connection method is in this destination. Include
   218      * embedded destinations.
   218      * embedded destinations.
   219      */
   219      */
   220     TBool ValidConnMethodIdInDestinationIncludeEmbedded(
   220     TBool ValidConnMethodIdInDestinationIncludeEmbedded(
   221             const TUint32& aConnMethodId ) const;
   221             const TUint32 aConnMethodId ) const;
   222 
   222 
   223     /**
   223     /**
   224      * Check if the given connection method is inside this destination and if
   224      * Check if the given connection method is inside this destination and if
   225      * it is in a 'locked' status. A locked connection method can't be deleted
   225      * it is in a 'locked' status. A locked connection method can't be deleted
   226      * nor removed from the destination. A connection method becomes locked
   226      * nor removed from the destination. A connection method becomes locked
   227      * if it is the only remaining connection method in a destination and a
   227      * if it is the only remaining connection method in a destination and a
   228      * virtual IAP points into that destination.
   228      * virtual IAP points into that destination.
   229      */
   229      */
   230     TBool ConnMethodInDestinationButLocked( const TUint32& aConnMethodId ) const;
   230     TBool ConnMethodInDestinationButLocked( const TUint32 aConnMethodId ) const;
   231 
   231 
   232     /**
   232     /**
   233      * Counts how many connection methods that require priority information are
   233      * Counts how many connection methods that require priority information are
   234      * currently in this destination. This excludes any virtual IAPs that point
   234      * currently in this destination. This excludes any virtual IAPs that point
   235      * to a destination or any embedded destinations from the count. Assumes
   235      * to a destination or any embedded destinations from the count. Assumes
   248     /**
   248     /**
   249      * Check if this destination has an embedded destination with the specified
   249      * Check if this destination has an embedded destination with the specified
   250      * ID. Checks the current (possibly unsaved) status of this destination
   250      * ID. Checks the current (possibly unsaved) status of this destination
   251      * handle, not the current status in database.
   251      * handle, not the current status in database.
   252      */
   252      */
   253     TBool HasEmbeddedWithId( const TUint32& aDestinationId ) const;
   253     TBool HasEmbeddedWithId( const TUint32 aDestinationId ) const;
   254 
   254 
   255     /**
   255     /**
   256      * After update/delete to database, refresh temporary ID to real ID if
   256      * After update/delete to database, refresh temporary ID to real ID if
   257      * necessary and refresh status information for any related handles for
   257      * necessary and refresh status information for any related handles for
   258      * all client sessions.
   258      * all client sessions.
   277     TBool AllMandatoryRecordsContainData() const;
   277     TBool AllMandatoryRecordsContainData() const;
   278 
   278 
   279     /**
   279     /**
   280      * Loads a requested type of record from database if it is not yet loaded.
   280      * Loads a requested type of record from database if it is not yet loaded.
   281      */
   281      */
   282     void RefreshRecordL( TCmmDbRecords aRecordType );
   282     void LoadRecordIfMissingL( TCmmDbRecords aRecordType );
   283 
   283 
   284     void LoadAllRecordsL();
   284     void LoadAllRecordsL();
   285     void SetMetadataInternetL( const TUint32& aMetadata );
   285     void SetMetadataInternetL( const TUint32 aMetadata );
   286     void SetMetadataHighlight( const TUint32& aMetadata );
   286     void SetMetadataHighlight( const TUint32 aMetadata );
   287     void SetMetadataHiddenAgentL( const TUint32& aMetadata );
   287     void SetMetadataHiddenAgentL( const TUint32 aMetadata );
   288     void SetMetadataLocalizationL( const TUint32& aMetadata );
   288     void SetMetadataLocalizationL( const TUint32 aMetadata );
   289     void SetMetadataPurposeL( const TUint32& aMetadata );
   289     void SetMetadataPurposeL( const TUint32 aMetadata );
   290 
   290 
   291     /**
   291     /**
   292      * Checks the current metadata for this destination, and verifies there is
   292      * Checks the current metadata for this destination, and verifies there is
   293      * no other conflicting destinations in the database.
   293      * no other conflicting destinations in the database.
   294      */
   294      */