Symbian
Symbian Developer Library

SYMBIAN OS V9.4

Feedback

[Index] [Previous] [Next]

#include <obexHeaderList.h>
Link against: obexmtmutil.lib

Class CObexHeaderList

class CObexHeaderList : public CBase;

Description

Encapsulates and owns a list of CObexHeader objects. Public users of this class can add CObexHeader objects

Derivation

Members

Defined in CObexHeaderList:

Inherited from CBase:


Construction and destruction


NewL()

IMPORT_C static CObexHeaderList* NewL();

Description

Factory function to return a new CObexHeaderList.

Return value

CObexHeaderList *

New CObexHeaderList object


NewLC()

IMPORT_C static CObexHeaderList* NewLC();

Description

Factory function to return a new CObexHeaderList and leave it on the cleanup stack.

Return value

CObexHeaderList *

New CObexHeaderList object


~CObexHeaderList()

IMPORT_C ~CObexHeaderList();

Description

Destructor which frees all allocated memory with the list.

[Top]


Member functions


AddHeader(const CObexHeader *)

IMPORT_C TInt AddHeader(const CObexHeader *aHeader);

Description

Add a CObexHeader object to the list. The CObexHeader object added should have its attribute, header ID and header value set before it is added to the list. CObexHeaderlist will not change these values of its contained CObexHeader objects

Parameters

const CObexHeader *aHeader

Pointer to a constant CObexHeader object

Return value

TInt

KErrNone, if the operation is successful, otherwise one of the system wide error codes


ExportToAttachmentL(CMsvAttachment &)const

IMPORT_C void ExportToAttachmentL(CMsvAttachment &aAttachment) const;

Description

Exports the Obex header list to the attachment. The header list is then stored with the attachment.

Parameters

CMsvAttachment &aAttachment

The attachment to store the header list for.

Leave codes

System-wide

error codes.


ImportFromAttachmentL(CMsvAttachment &)

IMPORT_C void ImportFromAttachmentL(CMsvAttachment &aAttachment);

Description

Imports the Obex header list from the attachment. The header list is retrieved and stored in this object. Any existing header data is over-written with the headers from the attachment. If the headers have not been set, this obex list will still be over written and result in zero headers.

Parameters

CMsvAttachment &aAttachment

The attachment to retieve the header list from.

Leave codes

System-wide

error codes.


ExternalizeL(RWriteStream &)const

IMPORT_C void ExternalizeL(RWriteStream &aWriteStream) const;

Description

Externalise the contents of the CObexHeaderList class to a stream in CMsvStore

Parameters

RWriteStream &aWriteStream

is a reference to a RMsvWriteStream

Leave codes

it

may leave with one of the system wide error code


InternalizeL(RReadStream &)

IMPORT_C void InternalizeL(RReadStream &aReadStream);

Description

Internalise the contents of the CObexHeaderList class from a stream in CMsvStore

Parameters

RReadStream &aReadStream

is a reference to a RMsvReadStream

Leave codes

it

may leave with one of the system wide error code


AddHeadersToBaseObjectL(CObexBaseObject &)

protected: IMPORT_C void AddHeadersToBaseObjectL(CObexBaseObject &aObexBaseObj);

Description

Add all the CObexHeader objects contained in a list to a CObexBaseObject.

Parameters

CObexBaseObject &aObexBaseObj

CObexBaseObject to add the objects to

Leave codes

Error

System wide error code


Count()const

protected: IMPORT_C TInt Count() const;

Description

Return the number of CObexHeader object pointers contained in the list.

Return value

TInt

The number of CObexHeader object pointers in the list


ObexHeaderL(TInt)

protected: IMPORT_C CObexHeader *& ObexHeaderL(TInt aPos);

Description

Get a non constant reference to the CObexHeader object pointer at position aPos into the list.

Parameters

TInt aPos

A list index specifying the CObexHeader object pointer to be returned

Return value

CObexHeader *&

A non constant reference to the CObexHeader object pointer

Leave codes

KErrArgument

aPos is out of range

KErrNotFound

The list is empty