Collapse all Symbian^3 Product Developer Library

CSubConParameterFamily Class Reference

class CSubConParameterFamily : public CBase

Container of RSubConnection parameter sets.

For each Parameter Type (Requested, Acceptable and Granted) it contains one generic and 0..N extended parameter sets.

Note: a CSubConParameterBundle or RSubConParameterBundle object can take ownership of a CSubConParameterFamily object, in this case, when the bundle is destroyed, this family object will also be destroyed (along with any parameter sets that are owned by the family).

THIS API IS DEPRECATED IN FAVOUR OF RParameterFamily

since v9.6

Inherits from

CSubConParameterFamily
- CBase

Public Member Functions
	~CSubConParameterFamily()
IMPORT_C void	AddExtensionSetL(CSubConExtensionParameterSet &, TParameterSetType)
IMPORT_C void	ClearAllParameters(TParameterSetType)
void	CopyFromFamilyL(RParameterFamily &)
void	CopyToFamilyL(RParameterFamily &)
IMPORT_C CSubConExtensionParameterSet *	FindExtensionSet(TUid, TParameterSetType)
IMPORT_C CSubConExtensionParameterSet *	FindExtensionSet(STypeId, TParameterSetType)
IMPORT_C CSubConGenericParameterSet *	GetGenericSet(TParameterSetType)
TUint32	Id()
IMPORT_C TUint	Length()
IMPORT_C TInt	Load(TPtrC8 &)
IMPORT_C CSubConParameterFamily *	LoadL(RSubConParameterBundle &, TPtrC8 &)
IMPORT_C CSubConParameterFamily *	LoadL(CSubConParameterBundle &, TPtrC8 &)
IMPORT_C CSubConParameterFamily *	NewL(RSubConParameterBundle &, TUint32)
IMPORT_C CSubConParameterFamily *	NewL(CSubConParameterBundle &, TUint32)
IMPORT_C void	SetGenericSetL(CSubConGenericParameterSet &, TParameterSetType)
IMPORT_C TInt	Store(TDes8 &)

Protected Member Functions
	CSubConParameterFamily(TUint32)
IMPORT_C void	ConstructL(RSubConParameterBundle &)
IMPORT_C void	ConstructL(CSubConParameterBundle &)
IMPORT_C TInt32	ExtractFamilyAndCreateBufferL(TPtrC8 &, TPtrC8 &)

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Public Member Enumerations
enum	TParameterSetType { ERequested = 0, EAcceptable = 1, EGranted = 2, ENumValues = 3 }

Protected Attributes
RMetaDataEComContainer	iExtensionSets

Private Attributes
const TUint32	iFamilyId
RMetaDataEComContainer	iGenericSets

Constructor & Destructor Documentation

CSubConParameterFamily(TUint32)

IMPORT_C

CSubConParameterFamily

(

TUint32

aFamilyId

)

[protected, explicit]

Empty sub-connection parameter family constructor

Parameters

TUint32 aFamilyId

identifier for the specific family type, currently only 4, QoS (KSubConQoSFamily),Authorisation (KSubConAuthorisationFamily), CallDescrParams (KSubConnCallDescrParamsFamily) and ContextDescrParams (KSubConnContextDescrParamsFamily), are defined.

~CSubConParameterFamily()

IMPORT_C

~CSubConParameterFamily

(

)

[virtual]

Sub-connection parameter family destructor. It cleans up the arrays deleting all the paarmeter sets it ownes

Member Functions Documentation

AddExtensionSetL(CSubConExtensionParameterSet &, TParameterSetType)

IMPORT_C void	AddExtensionSetL	(	CSubConExtensionParameterSet &	aExtensionSet,
			TParameterSetType	aType
		)

Adds an extension parameter set to a sub-connection parameter set family.

Note: The CSubConParameterFamily object takes ownership of the parameter set that is passed into this method. When the family object is destroyed, any parameter sets owned by this object will also be destroyed.

Exceptions

leaves

with KErrNoMemory in out of memeory conditions.

Parameters

CSubConExtensionParameterSet & aExtensionSet	Extension Parameter Set to be added to the family (family takes ownership)
TParameterSetType aType	The type of the set (requested, acceptable or granted)

ClearAllParameters(TParameterSetType)

IMPORT_C void

ClearAllParameters

(

TParameterSetType

aType

)

Clears (removes and deletes) all parameter sets with the type specified

Parameters

TParameterSetType aType

The type of the set to be deleted(requested, acceptable or granted)

ConstructL(RSubConParameterBundle &)

IMPORT_C void

ConstructL

(

RSubConParameterBundle &

aBundle

)

[protected]

Set up the sub-connection family with empty sets

Note: The aBundle parameter that is passed into this method will take ownership of the newly created CSubConParameterFamily object. When the bundle is destroyed, this family object will also be destroyed (along with any parameter sets that are owned by the family).

Exceptions

leaves

with KErrNoMemory in out of memory conditions

Parameters

RSubConParameterBundle & aBundle

Bundle (container) the family is to be added to

ConstructL(CSubConParameterBundle &)

IMPORT_C void

ConstructL

(

CSubConParameterBundle &

aBundle

)

[protected]

Set up the sub-connection family with empty sets

Exceptions

leaves

with KErrNoMemory in out of memory conditions

Parameters

CSubConParameterBundle & aBundle

Bundle (container) the family is to be added to

CopyFromFamilyL(RParameterFamily &)

void

CopyFromFamilyL

(

RParameterFamily &

aSrc

)

Copy the parameters of this CSubConParameterFamily from a RParameterFamily.

Parameters

RParameterFamily & aSrc

RParameterFamily object to copy from

CopyToFamilyL(RParameterFamily &)

void

CopyToFamilyL

(

RParameterFamily &

aDest

)

const

Copy the parameters of this CSubConParameterFamily to a RParameterFamily.

Parameters

RParameterFamily & aDest

RParameterFamily object to copy to

ExtractFamilyAndCreateBufferL(TPtrC8 &, TPtrC8 &)

IMPORT_C TInt32	ExtractFamilyAndCreateBufferL	(	TPtrC8 &	aBuffer,
			TPtrC8 &	aContainerBuffer
		)	[protected, static]

Used internally to extract the family id for the descriptor storing the serialised version of this object (and others). It also sets up a new buffer that is the section of the original buffer that represents this object only.

Parameters

TPtrC8 & aBuffer	Source buffer containing mulitple serialised objects (family at the start)
TPtrC8 & aContainerBuffer	Set up by this method and represents only the serialised data of the family object.

FindExtensionSet(TUid, TParameterSetType)

IMPORT_C CSubConExtensionParameterSet *	FindExtensionSet	(	TUid	aSetId,
			TParameterSetType	aType
		)

Searches a sub-connection parameter family for an extension parameter set. DO NOT USE this form of the method. It is broken. This is only capable of finding extension sets contained within IP Subconnection Provider, and these extension sets have been deprecated.

Parameters

TUid aSetId	Although a TUid, this is the extension class Id
TParameterSetType aType	The type of the set from TParameterSetType (ERequested, EAcceptable or EGranted)

FindExtensionSet(STypeId, TParameterSetType)

IMPORT_C CSubConExtensionParameterSet *	FindExtensionSet	(	STypeId	aSetId,
			TParameterSetType	aType
		)

Searches a sub-connection parameter family for an extension parameter set.

Parameters

STypeId aSetId	The STypeId of the extension set
TParameterSetType aType	The type of the set from TParameterSetType (ERequested, EAcceptable or EGranted)

GetGenericSet(TParameterSetType)

IMPORT_C CSubConGenericParameterSet *

GetGenericSet

(

TParameterSetType

aType

)

Accessor for the sub-connection generic parameter set of a family.

Parameters

TParameterSetType aType

The type of the set (requested, acceptable or granted)

Id()

TUint32

(

)

[inline]

Fetch the identity of the sub-connection parameter family

Length()

IMPORT_C TUint

Length

(

)

const

Calculates the length of buffer required to serialise this parameter set family.

Load(TPtrC8 &)

IMPORT_C TInt

Load

(

TPtrC8 &

aDes

)

Instructs this sub-connection family to set its members based on the serialiesd data in the buffer passed.

Parameters

TPtrC8 & aDes

Buffer containing the serialised family object

LoadL(RSubConParameterBundle &, TPtrC8 &)

IMPORT_C CSubConParameterFamily *	LoadL	(	RSubConParameterBundle &	aBundle,
			TPtrC8 &	aBuffer
		)	[static]

Creates a new sub-connection parameter set family from a buffer containing the serialised object.

Parameters

RSubConParameterBundle & aBundle	Family container (bundle) that this family is to be added to
TPtrC8 & aBuffer	Buffer containing the serialised object information

LoadL(CSubConParameterBundle &, TPtrC8 &)

IMPORT_C CSubConParameterFamily *	LoadL	(	CSubConParameterBundle &	aBundle,
			TPtrC8 &	aBuffer
		)	[static]

Creates a new sub-connection parameter set family from a buffer containing the serialised object.

Parameters

CSubConParameterBundle & aBundle	Family container (bundle) that this family is to be added to
TPtrC8 & aBuffer	Buffer containing the serialised object information

NewL(RSubConParameterBundle &, TUint32)

IMPORT_C CSubConParameterFamily *	NewL	(	RSubConParameterBundle &	aBundle,
			TUint32	aFamilyId
		)	[static]

Creates a new sub-connection parameter set family. This class is used as a container for a number of parameter sets (generic and extension) that make up a family. It is a specific instantiatable class and therefore creates an instance of CSubConParameterFamily without using ECOM.

Parameters

RSubConParameterBundle & aBundle	Family container (bundle) that this family is to be added to
TUint32 aFamilyId	identifier for the specific family type, currently only 4, QoS (KSubConQoSFamily),Authorisation (KSubConAuthorisationFamily), CallDescrParams (KSubConnCallDescrParamsFamily) and ContextDescrParams (KSubConnContextDescrParamsFamily), are defined.

NewL(CSubConParameterBundle &, TUint32)

IMPORT_C CSubConParameterFamily *	NewL	(	CSubConParameterBundle &	aBundle,
			TUint32	aFamilyId
		)	[static]

Parameters

CSubConParameterBundle & aBundle	Family container (bundle) that this family is to be added to.
TUint32 aFamilyId	identifier for the specific family type, currently only 4, QoS (KSubConQoSFamily),Authorisation (KSubConAuthorisationFamily), CallDescrParams (KSubConnCallDescrParamsFamily) and ContextDescrParams (KSubConnContextDescrParamsFamily), are defined.

SetGenericSetL(CSubConGenericParameterSet &, TParameterSetType)

IMPORT_C void	SetGenericSetL	(	CSubConGenericParameterSet &	aGenericSet,
			TParameterSetType	aType
		)

Assigns the generic parameter set of a sub-connection parameter set family.

Exceptions

leaves

with KAlreadyExists if a set is already assigned to the family.

Parameters

CSubConGenericParameterSet & aGenericSet	Generic Parameter Set to be assigned to the family (family takes ownership)
TParameterSetType aType	The type of the set (requested, acceptable or granted)

Store(TDes8 &)

IMPORT_C TInt

Store

(

TDes8 &

aDes

)

const

Instructs this sub-connection family to create a serialised version of itself and append it to the buffer that has been passed.

Parameters

TDes8 & aDes

Buffer to append the serialised object to

Member Enumerations Documentation

Enum TParameterSetType

Enumerators

ERequested = 0
EAcceptable = 1
EGranted = 2
ENumValues = 3

Member Data Documentation

RMetaDataEComContainer iExtensionSets

RMetaDataEComContainer

iExtensionSets

[protected]

const TUint32 iFamilyId

const TUint32

iFamilyId

[private]

RMetaDataEComContainer iGenericSets

RMetaDataEComContainer

iGenericSets

[private]