Symbian
Symbian Developer Library

SYMBIAN OS V9.4

Feedback

[Index] [Previous] [Next]

#include <SyncMLHistory.h>
Link against: smlclient.lib
This item is not part of the S60 5th Edition SDK

Class CSyncMLHistoryPushMsg

class CSyncMLHistoryPushMsg : public CSyncMLHistoryEntry;

Description

This class holds the result of a parsing a push msg. This class contains a counter that stores how many times the same message has been received.

Derivation

Members

Defined in CSyncMLHistoryPushMsg:

Inherited from CBase:

Inherited from CSyncMLHistoryEntry:


Construction and destruction


NewL()

IMPORT_C static CSyncMLHistoryPushMsg* NewL();

Description

This method creates a new Push Message entry representing a Push Message.

Return value

CSyncMLHistoryPushMsg *

New Push Message entry

Leave codes

KErrNoMemory

Insufficient free system RAM.


~CSyncMLHistoryPushMsg()

IMPORT_C virtual ~CSyncMLHistoryPushMsg();

Description

Destructor for CSyncMLHistoryPushMsg.

[Top]


Member functions


DynamicCast(CSyncMLHistoryEntry *)

static inline CSyncMLHistoryPushMsg* DynamicCast(CSyncMLHistoryEntry *);

Description

Parameters

CSyncMLHistoryEntry *

Return value

CSyncMLHistoryPushMsg *


DynamicCast(const CSyncMLHistoryEntry *)

static inline const CSyncMLHistoryPushMsg* DynamicCast(const CSyncMLHistoryEntry *);

Description

Parameters

const CSyncMLHistoryEntry *

Return value

const CSyncMLHistoryPushMsg *


ExternalizeL(RWriteStream &)const

IMPORT_C virtual void ExternalizeL(RWriteStream &) const;

Description

This method writes the details associated with this entry to the specified stream.

Parameters

RWriteStream &

The stream to write the entry to.


Profile()const

IMPORT_C virtual TSmlProfileId Profile() const;

Description

This method returns the ID of the Server Profile that this entry is associated with. Returns KSmlNullId if this entry is not associated with any Profile.

Return value

TSmlProfileId

The ID of the Server Profile that this entry is associated with.


TimeStamp()const

IMPORT_C virtual TTime TimeStamp() const;

Description

This method returns the time stamp of this entry. i.e. when the message was (last) received.

Return value

TTime

The time stamp in Universal Time.


ResultCode()const

IMPORT_C virtual TInt ResultCode() const;

Description

This method returns the result of parsing the push message.

Return value

TInt

The error code that the parsing completed with.


ReceivedCount()const

IMPORT_C TInt ReceivedCount() const;

Description

This method returns the number of times the message has been received.

Return value

TInt

The number of times the message has been received


MsgDigest()const

IMPORT_C const TDesC8& MsgDigest() const;

Description

This method returns an MD5 digest of the message body. This is used by the History Log for identifying duplicate messages.

Return value

const TDesC8 &

The MD5 message digest.


AlertCount()const

IMPORT_C TInt AlertCount() const;

Description

This method returns the number of Alerts in this entry. Each Alert represents a Sync Job, requested by the sender of the Push Message. Typically a Push Message only contains one Alert.

Return value

TInt

The number of alerts.


Alert(TInt)const

IMPORT_C const CSmlAlertInfo& Alert(TInt aIndex) const;

Description

This method returns details of the Alert at the specified index.

Parameters

TInt aIndex

The index of the Alert to retrieve.

Return value

const CSmlAlertInfo &

The Alert details.


IncReceivedCount()

IMPORT_C void IncReceivedCount();

Description

This method increments the counter indicating how many times the message has been received. Also updates the entry timestamp.


SetMsgDigest(const TDesC8 &)

IMPORT_C void SetMsgDigest(const TDesC8 &);

Description

This method sets the digest for the message, and sets the received count to 1.

Parameters

const TDesC8 &

The MD5 message digest.


AddAlertsL(RPointerArray< CSmlAlertInfo > &)

IMPORT_C void AddAlertsL(RPointerArray< CSmlAlertInfo > &);

Description

This method moves the Alerts from the supplied array into the entry. The entry takes ownership of all the alerts in the array. This method will clear any Alerts currently in the entry.

Parameters

RPointerArray< CSmlAlertInfo > &

An array of Alerts.

Leave codes

KErrNoMemory

Insufficient free system RAM.


ResetAlerts()

IMPORT_C void ResetAlerts();

Description

This method will clear any Alerts currently in the entry.


SetResultCode(TInt)

IMPORT_C void SetResultCode(TInt aResultCode);

Description

This method will set the result code for this entry.

Parameters

TInt aResultCode

The result code for the this entry


InternalizeL(RReadStream &)

private: virtual void InternalizeL(RReadStream &);

Description

Parameters

RReadStream &