CCmDestinationImpl Class Reference
class CCmDestinationImpl : public CBase |
RCmDestination is for getting/setting values of a network destination. cmmanager.lib
- Since
- S60 v3.2
Public Member Functions |
---|
| ~CCmDestinationImpl() |
TInt
| AddConnectionMethodL(CCmPluginBase &) |
TInt
| AddEmbeddedDestinationL(CCmDestinationImpl &) |
TBool
| CanUseToConnectL() |
TBool
| CheckIfCMExistsL(CCmPluginBase &) |
void | CheckIfEmbeddedL(TInt) |
void | Close() |
CCmManagerImpl * | Cmmgr() |
void | ConnectMethodIdArrayL(RArray< TUint32 > &) |
CCmPluginBase * | ConnectionMethodByIDL(TUint32) |
IMPORT_C TInt | ConnectionMethodCount() |
void | ConnectionMethodDeletedL(const CCmPluginBase &) |
IMPORT_C CCmPluginBaseEng * | ConnectionMethodL(TInt) |
CCmPluginBase * | CreateConnectionMethodL(TUint32) |
CCmPluginBase * | CreateConnectionMethodL(TUint32, TUint32) |
void | DecrementRefCounter() |
void | DeleteConnectionMethodL(CCmPluginBase &) |
IMPORT_C void | DeleteLD() |
TUint32
| ElementId() |
CCmDestinationImpl * | EmbeddedL() |
IMPORT_C CCmPluginBase * | GetConnectionMethodL(TInt) |
CCmDestinationData * | GetData() |
TUint32
| GetDestinationAPTagId() |
TInt
| GetRefCounter() |
CGulIcon * | IconIdL(CCmManagerImpl &, CommsDat::TMDBElementId) |
IMPORT_C CGulIcon * | IconL() |
TUint32
| Id() |
TBool
| IdIsValid() |
void | IncrementRefCounter() |
IMPORT_C TBool | IsConnectedL() |
IMPORT_C TBool | IsHidden() |
TUint32
| MetadataL(CMManager::TSnapMetadataField) |
void | ModifyPriorityL(CCmPluginBase &, TUint) |
IMPORT_C HBufC * | NameLC() |
IMPORT_C CCmDestinationImpl * | NewL(CCmManagerImpl &, const TDesC &) |
CCmDestinationImpl * | NewL(CCmManagerImpl &, CCmDestinationData *) |
IMPORT_C CCmDestinationImpl * | NewL(CCmManagerImpl &, TUint) |
CCmDestinationImpl * | NewL(CCmManagerImpl &, const TDesC &, TUint32) |
CCmDestinationImpl * | NewLC(CCmDestinationData *) |
void | PluginClosed(CCmPluginBase *) |
TUint
| PriorityL(CCmPluginBaseEng &) |
TUint
| PriorityL(CCmPluginBase &) |
IMPORT_C CMManager::TProtectionLevel | ProtectionLevel() |
CMManager::TProtectionLevel
| ProtectionLevelL(CCmManagerImpl &, CommsDat::TMDBElementId) |
void | ReLoadConnectionMethodsL() |
void | RemoveConnectionMethodL(const CCmPluginBase &) |
void | RemoveConnectionMethodL(const CCmPluginBaseEng &) |
IMPORT_C void | RemoveFromPool() |
void | SetData(CCmDestinationData *) |
IMPORT_C void | SetHiddenL(TBool) |
IMPORT_C void | SetIconL(TUint32) |
void | SetMetadataL(CMManager::TSnapMetadataField, TUint32) |
IMPORT_C void | SetNameL(const TDesC &) |
IMPORT_C void | SetProtectionL(CMManager::TProtectionLevel) |
IMPORT_C void | UpdateL() |
Private Member Functions |
---|
| CCmDestinationImpl(CCmManagerImpl &) |
TInt
| AddToArrayL(CPluginItem *) |
void | CheckIfDestinationIdExistsL(TUint32) |
void | CheckIfDestinationNameExistL(const TDesC &) |
void | CheckIfInternetExistsL() |
void | CheckIfLocalisedDestExistL(TUint32) |
void | CheckIfNameModifiedL(CCDSnapRecord *) |
void | CheckIfPurposeExistL(TUint32) |
void | CheckIfReferencedByVirtualCML() |
void | CleanUpEmbeddedL(TUint32) |
void | CleanUpSeamlessnessTableL(TUint32) |
void | CleanUpSnapMetadataTableL(TUint32) |
void | CommitTransactionL(TInt) |
TInt
| ConnectionMethodIndex(TUint32) |
void | ConstructL(const TDesC &) |
void | ConstructL(const TDesC &, TUint32) |
void | ConstructL(TUint) |
CCmPluginBase * | CreateConnectionMethodL(TUid, TCmPluginInitParam &) |
TUint32
| CreateDestinationAPTagIdL() |
void | CreateEmbeddedDestinationPluginL(CPluginItem &, TInt) |
void | DeleteConnectionMethodsL() |
void | DeleteIAPRecordsL(CommsDat::CMDBRecordBase *) |
void | DeleteRelatedRecordsL(TInt) |
TInt
| FindConnectionMethodL(const CCmPluginBase &) |
TInt
| FindConnectionMethodL(const CCmPluginBaseEng &) |
TBool
| HasEmbeddedL() |
CGulIcon * | IconL(TInt) |
void | InitializeDestAPRecordL() |
TInt
| InsertPriorityMethodL(TUint32, TUint32) |
TInt
| InsertSameMethodL(TUint32, TBool) |
void | LoadConnectionMethodsL() |
void | LoadDestAPRecordL(TUint32) |
void | LoadEmbeddedDestinationPluginL(CPluginItem &) |
void | LoadNetworkRecordL(TUint32) |
void | LoadPluginL(CPluginItem &) |
void | LoadSNAPMetadataTableL() |
void | OpenTransactionLC() |
TBool
| PrioDataL(CPluginItem *, TUint32 &, TUint32 &, TUint32 &) |
CMManager::TProtectionLevel
| ProtectionLevel(CCDSNAPMetadataRecord *) |
void | RollbackTransaction() |
CommsDat::CMDBSession & | Session() |
void | SetAttribute(CommsDat::CMDBRecordBase *, TUint32, TBool) |
void | SetDefaultCprL() |
void | SetDefaultMCprL() |
void | SetDefaultProtocolL() |
void | SetDefaultSCprL() |
void | SetDefaultTierManagerL() |
void | SetIdL(TInt) |
TInt
| SortRecordsByPriority(const CommsDat::CMDBRecordBase &, const CommsDat::CMDBRecordBase &) |
void | UpdateConnectionMethodsL() |
void | UpdateDestAPRecordL() |
void | UpdateNetworkRecordL() |
void | UpdateProtectionL() |
void | UpdateSNAPMetadataTableL() |
void | UpdateSNAPTableL() |
Constructor & Destructor Documentation
CCmDestinationImpl(CCmManagerImpl &)
Member Functions Documentation
AddConnectionMethodL(CCmPluginBase &)
AddEmbeddedDestinationL(CCmDestinationImpl &)
AddToArrayL(CPluginItem *)
Add an item to the Connection Method array based on bearer priority table.
CanUseToConnectL()
Checks if this destination plus a possible embedded destinaion contains a connection method which can be used for a connection Doesn't check VPNs!
CheckIfCMExistsL(CCmPluginBase &)
Checks if this destination already contains the given Connection Method
Parameters
CCmPluginBase & aConnectionMethod | Connection Method to be checked whether it already exists. |
CheckIfDestinationIdExistsL(TUint32)
void | CheckIfDestinationIdExistsL | ( | TUint32 | aDestId | ) | [private] |
Checks that there isn't any destination with the given (tag)id.
CheckIfDestinationNameExistL(const TDesC &)
void | CheckIfDestinationNameExistL | ( | const TDesC & | aName | ) | [private] |
Check if there is destination with this name. Leaves with KErrAlreadyExists if name already exists
Parameters
const TDesC & aName | destination name |
CheckIfEmbeddedL(TInt)
void | CheckIfEmbeddedL | ( | TInt | aId | ) | |
Check if the destination element id is already embeded. Leaves with KErrNotSupported (multiple levels of embedding is not supported)
CheckIfInternetExistsL()
void | CheckIfInternetExistsL | ( | ) | [private] |
Checks if there's another SNAP with Internet bit set. Leaves with KErrAlreadyExists if so.
CheckIfLocalisedDestExistL(TUint32)
void | CheckIfLocalisedDestExistL | ( | TUint32 | aValue | ) | [private] |
Checks if there's another SNAP with the same localised bit set. Leaves with KErrAlreadyExists if so.
CheckIfNameModifiedL(CCDSnapRecord *)
Check if the name of the passed record is the same as the name of network one, and update it if not.
Parameters
CCDSnapRecord * aRecord | record to be checked and updated if needed |
CheckIfPurposeExistL(TUint32)
void | CheckIfPurposeExistL | ( | TUint32 | aValue | ) | [private] |
Checks if there's another SNAP with the same purpose bit set. Leaves with KErrAlreadyExists if so.
CheckIfReferencedByVirtualCML()
void | CheckIfReferencedByVirtualCML | ( | ) | [private] |
Checks if this(current) destination is referenced by any Virtual Connection Method.
CleanUpEmbeddedL(TUint32)
void | CleanUpEmbeddedL | ( | TUint32 | aDestId | ) | [private] |
Embedded dest is considered to be removed from the commsdat by third party (someone else external). Snap Metadata entries should also be removed.
CleanUpSeamlessnessTableL(TUint32)
void | CleanUpSeamlessnessTableL | ( | TUint32 | aIapId | ) | [private] |
IAP is considered to be removed from the commsdat by third party (someone else external). Seamlessness entries should also be removed.
CleanUpSnapMetadataTableL(TUint32)
void | CleanUpSnapMetadataTableL | ( | TUint32 | aSnap | ) | [private] |
Embedded dest is considered to be removed from the commsdat by third party (someone else external). Snap Metadata entries should also be removed.
Close()
Performs RollbackTransactionL().
Cmmgr()
Returns pointer to the CmManager object Used in 'R' classes
CommitTransactionL(TInt)
void | CommitTransactionL | ( | TInt | aError | ) | [private] |
-
Check if the transaction is ours.
-
If yes, commits the transaction.
-
anyway does nothing aError - error id
ConnectMethodIdArrayL(RArray< TUint32 > &)
ConnectionMethodByIDL(TUint32)
Returns a reference to the connection method. The index must be less than the return value of ConnMethodCount()
Parameters
TUint32 anIapId | IAP id of the queried connection method |
ConnectionMethodCount()
IMPORT_C TInt | ConnectionMethodCount | ( | ) | |
Returns the number of connection methods of the destination
ConnectionMethodDeletedL(const CCmPluginBase &)
void | ConnectionMethodDeletedL | ( | const CCmPluginBase & | aConnectionMethod | ) | |
Notification from child plugin that it was deleted. Remove it from the array and update priorities.
Parameters
const CCmPluginBase & aConnectionMethod | child connection method that was deleted. |
ConnectionMethodIndex(TUint32)
Return the index value of the connection method.
Parameters
TUint32 aCmId | id of the connection method |
ConstructL(const TDesC &)
void | ConstructL | ( | const TDesC & | aName | ) | [private] |
ConstructL(const TDesC &, TUint32)
void | ConstructL | ( | const TDesC & | aName, |
| TUint32 | aDestId |
| ) | [private] |
ConstructL(TUint)
void | ConstructL | ( | TUint | aDestinationId | ) | [private] |
CreateConnectionMethodL(TUint32)
Create a connection method belonging to the destination
CreateConnectionMethodL(TUint32, TUint32)
Create a connection method belonging to the destination
Parameters
TUint32 aBearerType | - implementation uid of the connection method |
TUint32 aConnMethId | - Predefined id for the connection method. |
CreateConnectionMethodL(TUid, TCmPluginInitParam &)
Create a connection method belonging to the destination
Parameters
TUid aImplementationUid | - implementation uid of the connection method |
TCmPluginInitParam & aParams | - plugin init param |
CreateDestinationAPTagIdL()
TUint32
| CreateDestinationAPTagIdL | ( | ) | [private] |
Creates an unique (tag)id to the record of the accesspoint table for this destination.
CreateEmbeddedDestinationPluginL(CPluginItem &, TInt)
void | CreateEmbeddedDestinationPluginL | ( | CPluginItem & | aItem, |
| TInt | aDestinationId |
| ) | [private] |
Create embedded destination plugin.
DecrementRefCounter()
void | DecrementRefCounter | ( | ) | |
Increments the reference counter. Used by the object pool.
DeleteConnectionMethodL(CCmPluginBase &)
Remove a connection method from a destination and delete it on update. Exception: conenction method is not deleted if it's referenced from any other destination.
Parameters
CCmPluginBase & aConnectionMethod | the connection method to be deleted |
DeleteConnectionMethodsL()
void | DeleteConnectionMethodsL | ( | ) | [private] |
Delete all connection methods.
- Since
- S60 3.2
DeleteIAPRecordsL(CommsDat::CMDBRecordBase *)
Reference to a non-existing IAP found in the SNAP table. Remove the SNAP record and the metadata record of this IAP. IAP is most probably deleted by APEngine.
DeleteLD()
Deletes it's connection methods from comms.dat (unless shared) then deletes itself
DeleteRelatedRecordsL(TInt)
void | DeleteRelatedRecordsL | ( | TInt | aCount | ) | [private] |
Deletes all the recordsrelated to this Destination to be deleted.
ElementId()
Returns the destination's ElementId attribute
EmbeddedL()
Returns pointer to embedded destination if there is any
FindConnectionMethodL(const CCmPluginBase &)
Find the connection method in iConnMethodArray.
Parameters
const CCmPluginBase & aConnectionMethod | connection method to be searched for |
FindConnectionMethodL(const CCmPluginBaseEng &)
Find the connection method in iConnMethodArray.
GetConnectionMethodL(TInt)
Returns a reference to the connection method. The index must be less than the return value of ConnMethodCount()
GetData()
Returns iData. Used by the object pool and the API oprators.
GetDestinationAPTagId()
Returns the Id of this Destination which is used to identify the Destination. It is the Id saved to Destination Access Point's Tag field.
GetRefCounter()
Returns the reference counter. Used by the object pool.
HasEmbeddedL()
TBool
| HasEmbeddedL | ( | ) | [private] |
Check if the destination contains and embedded destination
- Since
- S60 3.2
IconIdL(CCmManagerImpl &, CommsDat::TMDBElementId)
IconL()
Returns the Icon pointer This fucton leaves if the client does not have a valid UI context
Id()
Returns the destination's Id attribute
IdIsValid()
Indicates if the Id is valid or if this is a new object which sitll haven't been updated. Used by the object pool.
IncrementRefCounter()
void | IncrementRefCounter | ( | ) | |
Increments the reference counter. Used by the object pool.
InitializeDestAPRecordL()
void | InitializeDestAPRecordL | ( | ) | [private] |
Initializes the Destination AccessPoint record deleted.
InsertPriorityMethodL(TUint32, TUint32)
Determines the position of the inserted item into the cm list. This determination is based on the priority and the extension level of the cm's.
Parameters
TUint32 aPrio | default bearer type of the inserted cm |
TUint32 aExtLevel | extension level of the inserted cm |
InsertSameMethodL(TUint32, TBool)
Determines the position of the inserted item into the cm list. This determination is based on the similarity of the bearer types. The inserted position is just after the last item with the same bearer type and virtuality - if exist else -1.
Parameters
TUint32 aBearerType | bearer type od the inserted cm |
TBool aIsVirtual | virtuality of the inserted cm |
IsConnectedL()
IMPORT_C TBool | IsConnectedL | ( | ) | const |
Returns if there's connection created with any of the destination's connection method.
IsHidden()
Returns that the destination is hidden or not.
LoadConnectionMethodsL()
void | LoadConnectionMethodsL | ( | ) | [private] |
Load connection methods of the destination
LoadDestAPRecordL(TUint32)
void | LoadDestAPRecordL | ( | TUint32 | aDestinationId | ) | [private] |
Load Destination AP record. Destination id is passed, because id is from the client application, and destinaion id is the network id for them. :)
Parameters
TUint32 aDestinationId | network record id |
LoadEmbeddedDestinationPluginL(CPluginItem &)
void | LoadEmbeddedDestinationPluginL | ( | CPluginItem & | aItem | ) | [private] |
Load embedded destination plugin.
LoadNetworkRecordL(TUint32)
void | LoadNetworkRecordL | ( | TUint32 | aDestinationId | ) | [private] |
Load network record. Destination id is passed, because id is from the client application, and destinaion id is the network id for them. :)
Parameters
TUint32 aDestinationId | network record id |
LoadPluginL(CPluginItem &)
LoadSNAPMetadataTableL()
void | LoadSNAPMetadataTableL | ( | ) | [private] |
MetadataL(CMManager::TSnapMetadataField)
ModifyPriorityL(CCmPluginBase &, TUint)
Set the CCMItem's priority based on the passed new index
Parameters
CCmPluginBase & aCCMItem | The connection method item |
TUint aIndex | The new index of the item in the list |
NameLC()
Returns the destination's Name attribute HBuf ownership is passed to the caller
NewL(CCmManagerImpl &, const TDesC &)
Epoc constructor This should be used only by the object pool
NewL(CCmManagerImpl &, CCmDestinationData *)
Epoc constructor This should be used only by the object pool
NewL(CCmManagerImpl &, TUint)
Epoc constructor This should be used only by the object pool
NewL(CCmManagerImpl &, const TDesC &, TUint32)
Epoc constructor This should be used only by the object pool
NewLC(CCmDestinationData *)
Epoc constructor This should be used only by the 'R' classes
OpenTransactionLC()
void | OpenTransactionLC | ( | ) | [private] |
PluginClosed(CCmPluginBase *)
Set iPlugin to NULL in plugin array, but not delete it. Next reference to this connection method will load the plugin again.
PrioDataL(CPluginItem *, TUint32 &, TUint32 &, TUint32 &)
Retrieves the base of the priority counts in cm list It is the data of the plugin in case of none VPN. It is the data of the underlying cm in case of VPN over cm. It is "wildcard" in case of VPN over destination. aRetBearer and aRetExtLevel are not filled in this case
Parameters
CPluginItem * aItem | the plugin list item which data is get |
TUint32 & aRetPrio | the default priority of the cm in return |
TUint32 & aRetBearer | the bearer of the cm in return |
TUint32 & aRetExtLevel | the extenson level of the cm in return |
PriorityL(CCmPluginBaseEng &)
PriorityL(CCmPluginBase &)
Return the priority of the passed connection method
ProtectionLevel()
Returns that the destination is protected or not.
ProtectionLevel(CCDSNAPMetadataRecord *)
ProtectionLevelL(CCmManagerImpl &, CommsDat::TMDBElementId)
ReLoadConnectionMethodsL()
void | ReLoadConnectionMethodsL | ( | ) | |
Reload connection method under this destination so as to keep synchronization with CommsDat
RemoveConnectionMethodL(const CCmPluginBase &)
void | RemoveConnectionMethodL | ( | const CCmPluginBase & | aConnectionMethod | ) | |
Remove connection method from the destination
Parameters
const CCmPluginBase & aConnectionMethod | connection method to be removed |
RemoveConnectionMethodL(const CCmPluginBaseEng &)
Remove connection method from the destination
RemoveFromPool()
IMPORT_C void | RemoveFromPool | ( | ) | |
Removes this destination from the object pool.
RollbackTransaction()
void | RollbackTransaction | ( | ) | [private] |
Session()
Returns the CommsDat session. Do not close!
SetAttribute(CommsDat::CMDBRecordBase *, TUint32, TBool)
Set or clear attribute record of which the attribute is to be set or clear attribute to be set or clear ETrue to set
SetData(CCmDestinationData *)
Used by the object pool and the API oprators.
SetDefaultCprL()
void | SetDefaultCprL | ( | ) | [private] |
Sets the default Connection Provider to the accesspoint record for this destination.
SetDefaultMCprL()
void | SetDefaultMCprL | ( | ) | [private] |
Sets the default Meta Connection Provider to the accesspoint record for this destination.
SetDefaultProtocolL()
void | SetDefaultProtocolL | ( | ) | [private] |
Sets the default Protocol to the accesspoint record for this destination.
SetDefaultSCprL()
void | SetDefaultSCprL | ( | ) | [private] |
Sets the default Subconnection Provider to the accesspoint record for this destination.
SetDefaultTierManagerL()
void | SetDefaultTierManagerL | ( | ) | [private] |
Sets the default Tier Manager to the accesspoint record for this destination.
SetHiddenL(TBool)
IMPORT_C void | SetHiddenL | ( | TBool | aHidden | ) | |
Set that the destination is hidden or not.
Parameters
TBool aHidden | - True if it is hidden. |
SetIconL(TUint32)
IMPORT_C void | SetIconL | ( | TUint32 | anIndex | ) | |
Set the destination's Icon index. This fucton leaves if the client does not have a valid UI context
SetIdL(TInt)
void | SetIdL | ( | TInt | aDestId | ) | [private] |
Sets the given (tag)id to the accesspoint record
SetMetadataL(CMManager::TSnapMetadataField, TUint32)
SetNameL(const TDesC &)
IMPORT_C void | SetNameL | ( | const TDesC & | aName | ) | |
Set the destination's Name attribute. Leaves if the name already exists
SetProtectionL(CMManager::TProtectionLevel)
Set the protection of the destination.
SortRecordsByPriority(const CommsDat::CMDBRecordBase &, const CommsDat::CMDBRecordBase &)
Compare two records from DNIAP by their priority field.
UpdateConnectionMethodsL()
void | UpdateConnectionMethodsL | ( | ) | [private] |
Update every connection method.
UpdateDestAPRecordL()
void | UpdateDestAPRecordL | ( | ) | [private] |
Create or update the record of the accesspoint table for this destination.
UpdateL()
Update all the attributes of the Connection Methods and the Destination.
UpdateNetworkRecordL()
void | UpdateNetworkRecordL | ( | ) | [private] |
Create or update the record of the network table for this destination.
UpdateProtectionL()
void | UpdateProtectionL | ( | ) | [private] |
Update protection attributes of every connection method if changed.
UpdateSNAPMetadataTableL()
void | UpdateSNAPMetadataTableL | ( | ) | [private] |
Update the SNAP Metadata table
UpdateSNAPTableL()
void | UpdateSNAPTableL | ( | ) | [private] |
Member Data Documentation
CCmDestinationData * iData
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.