Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

[Index] [Glossary] [Previous] [Next]



Location: msvstd.h
Link against: msgs.lib

Class TMsvEntry

TMsvEntry

Support

Supported from 5.0

Description

Represents an entry in the Message Server index. MTM implementations and message client applications use it to access and manipulate index entry values. Note that a TMsvEntry is effectively a local cache of the index entry, and changes to it are not automatically written into the index. To commit changes to the Message Server, you need to call CMsvEntry::ChangeL() (or CMsvServerEntry::ChangeEntry()).

To avoid repetition, the functions and data members are simply listed here, without detailed explanation of the fields. The public data members can be used to get and set the values of some index entry fields.

In pre-Unicode versions this class had an import library ment.lib.

Defined in TMsvEntry:
Attachment(), Complete(), Connected(), DecPcSyncCount(), Deleted(), ExternalizeL(), Failed(), Folder(), Id(), InPreparation(), IncPcSyncCount(), InternalizeL(), MultipleRecipients(), New(), OffPeak(), Operation(), Owner(), Parent(), PcSyncCount(), Priority(), ReadOnly(), Scheduled(), SendingState(), SetAttachment(), SetComplete(), SetConnected(), SetFailed(), SetInPreparation(), SetMultipleRecipients(), SetNew(), SetOffPeak(), SetOperation(), SetPriority(), SetReadOnly(), SetScheduled(), SetSendingState(), SetStandardFolder(), SetUnread(), SetVisible(), StandardFolder(), Store(), TMsvEntry(), Unread(), Visible(), iBioType, iDate, iDescription, iDetails, iError, iMtm, iMtmData1, iMtmData2, iMtmData3, iRelatedId, iServiceId, iSize, iType, iWdpPortNumber, operator=(), operator==()


Constructors


TMsvEntry()

TMsvEntry();

Description

Initialises the new object to null values: 0 for integer values, KMsvNullIndexEntryId for IDs, and KUidMsvNullEntry for UIDs.


TMsvEntry()

TMsvEntry(const TMsvEntry& aEntry);

Description

Creates a simple copy of the entry, so the TPtrC members iDescription and iDetails will point to the same descriptor data in the original and new objects.

Parameters

const TMsvEntry& aEntry

The entry to copy

[Top]


Equality and assignment


operator=()

TMsvEntry& operator=(const TMsvEntry& aEntry);

Description

Acts similarly to the copy constructor: i.e. it makes a simple copy of entry, so the TPtrC entry description and details members will point to the same descriptor data in the original and new objects.

Parameters

const TMsvEntry& aEntry

The entry from which to assign

Return value

TMsvEntry&

Object after assignment


operator==()

TBool operator==(const TMsvEntry& aEntry) const;

Description

Tests whether the fields of the specified entry are equal to those of this object. The contents, rather than pointer values, of the TPtrC members are compared.

Parameters

const TMsvEntry& aEntry

The entry with which to compare

Return value

TBool

ETrue if the entries are equal, else EFalse

[Top]


Internalising and externalising


ExternalizeL()

void ExternalizeL(RWriteStream& aStream) const;    

Description

Writes the object into the stream specified.

Parameters

RWriteStream& aStream

Stream to which to write

Leave codes

 

Standard stream leave codes.


InternalizeL()

void InternalizeL(RReadStream& aStream);

Description

Reads an externalised object from the specified stream.

Parameters

RReadStream& aStream

Stream from which to read

Leave codes

 

Standard stream leave codes.

[Top]


Accessors


Attachment()

TBool Attachment() const;

Description

Gets the value of the attachment flag.

Return value

TBool

The value of the attachment flag


Complete()

TBool Complete() const;

Description

Gets the value of the message complete flag.

Return value

TBool

The value of the message complete flag


Connected()

TBool Connected() const;

Description

Gets the value of the remote server connection flag.

Return value

TBool

The value of the remote server connection flag


Deleted()

TBool Deleted() const;

Description

Gets the value of the deleted flag.

Return value

TBool

The value of the deleted flag


Failed()

TBool Failed() const;

Description

Gets the value of the message send failed flag.

Return value

TBool

The value of the message send failed flag


Folder()

TBool Folder() const;

Support

Withdrawn in 5.1

Description

Gets the value of the folder flag.

For Unicode EPOC releases, the folder flag does not exist. Equivalent functionality can be obtained through CMsvEntry::HasDirectoryL().

Return value

TBool

The value of the folder flag


Id()

TMsvId Id() const;

Description

Gets the value of the entry ID.

Return value

TMsvId

The value of the entry ID


InPreparation()

TBool InPreparation() const;

Description

Gets the value of the in preparation flag.

Return value

TBool

The value of the in preparation flag


MultipleRecipients()

TBool MultipleRecipients() const;

Description

Gets the value of the multiple recipients flag.

Return value

TBool

The value of the multiple recipients flag


New()

TBool New() const;

Description

Gets the value of the new message flag.

Return value

TBool

The value of the new message flag


OffPeak()

TBool OffPeak() const;

Support

Supported from 6.0

Description

Gets the off-peak flag.

Return value

TBool

The value of the off-peak flag


Operation()

TBool Operation() const;

Description

Gets the value of the disconnected operation queued flag.

Return value

TBool

The value of the disconnected operation queued flag


Owner()

TBool Owner() const;

Description

Gets the value of the owner flag.

Return value

TBool

The value of the owner flag


Parent()

TMsvId Parent() const;

Description

Gets the value of the parent ID.

Return value

TMsvId

The value of the parent ID


PcSyncCount()

TInt PcSyncCount() const;

Description

Gets the value of the PC synchronisation field.

Return value

TInt

The value of the PC synchronisation field


Priority()

TMsvPriority Priority() const;

Description

Gets the value of the message priority field.

Return value

TMsvPriority

The value of the message priority field


ReadOnly()

TBool ReadOnly() const;

Description

Gets the value of the read-only flag.

Return value

TBool

The value of the read-only flag


Scheduled()

TBool Scheduled() const;

Support

Supported from 6.0

Description

Gets the scheduled flag.

Return value

TBool

The value of the scheduled flag


SendingState()

TInt SendingState() const;

Support

Supported from 6.0

Description

Gets the sending state.

Return value

TInt

The sending state


StandardFolder()

TBool StandardFolder() const;

Description

Gets the value of the standard folder flag.

Return value

TBool

The value of the standard folder flag


Store()

TBool Store() const;

Support

Withdrawn in 5.1

Description

Tests the value of the message store flag.

For Unicode releases, the message store flag does not exist. Equivalent functionality can be obtained through CMsvEntry::HasStoreL().

Return value

TBool

The value of the message store flag


Unread()

TBool Unread() const;

Description

Gets the value of the message unread flag.

Return value

TBool

The value of the message unread flag


Visible()

TBool Visible() const;

Description

Gets the value of the entry visible flag.

Return value

TBool

The value of the entry visible flag

[Top]


Mutators

Description

The following functions can be used to set the values of index entry fields.


DecPcSyncCount()

void DecPcSyncCount();

Description

Decrements the PC synchronisation field.


IncPcSyncCount()

void IncPcSyncCount();

Description

Increments the PC synchronisation field.


SetAttachment()

void SetAttachment(TBool aAttachmentFlag);

Description

Sets the attachment flag.

Parameters

TBool aAttachmentFlag

Value for the attachment flag


SetComplete()

void SetComplete(TBool aComplete);

Description

Sets the message complete flag.

Parameters

TBool aComplete

Value for the message complete flag


SetConnected()

void SetConnected(TBool aConnected);

Description

Sets the remote server connection flag.

Parameters

TBool aConnected

Value for the remote server connection flag


SetFailed()

void SetFailed(TBool aFailed);

Description

Sets the message send failed flag.

Parameters

TBool aFailed

Value for the message send failed flag


SetInPreparation()

void SetInPreparation(TBool aInPreparation);

Description

Sets the in-preparation flag.

Parameters

TBool aInPreparation

Value for the in-preparation flag


SetMultipleRecipients()

void SetMultipleRecipients(TBool aMultipleRecipients);    

Description

Sets the multiple recipients flag.

Parameters

TBool aMultipleRecipients

Value for the multiple recipients flag


SetNew()

void SetNew(TBool aNew);

Description

Sets the message new flag.

Parameters

TBool aNew

Value for the message new flag


SetOffPeak()

void SetOffPeak(TBool aOffPeak);

Support

Supported from 6.0

Description

Sets the off-peak flag.

Parameters

TBool aOffPeak

Value for off-peak flag.


SetOperation()

void SetOperation(TBool aOperation);

Description

Sets the disconnected operation queued flag.

Parameters

TBool aOperation

Value for the disconnected operation queued flag


SetPriority()

void SetPriority(TMsvPriority aPriority);

Description

Sets the message priority.

Parameters

TMsvPriority aPriority

Value for the message priority


SetReadOnly()

void SetReadOnly(TBool aReadOnly);

Description

Sets the read-only flag.

Parameters

TBool aReadOnly

Value for the read-only flag


SetScheduled()

void SetScheduled(TBool aScheduled);

Support

Supported from 6.0

Description

Sets the scheduled flag.

Parameters

TBool aScheduled

Value for the scheduled flag.


SetSendingState()

void SetSendingState(TInt aSendingState) const;

Support

Supported from 6.0

Description

Sets the sending state.

Parameters

TInt aSendingState

The sending state. This must be a value between 0x00 and KMsvSendStateMax.


SetStandardFolder()

void SetStandardFolder(TBool aStandardFolder);

Description

Sets the standard folder flag.

Parameters

TBool aStandardFolder

Value for the standard folder flag


SetUnread()

void SetUnread(TBool aRead);

Description

Sets the message unread flag.

Parameters

TBool aRead

Value for the message unread flag


SetVisible()

void SetVisible(TBool aVisible);

Description

Sets the entry visible flag.

Parameters

TBool aVisible

Value for the entry visible flag

[Top]


Public member data


iDate

TTime iDate

Description

Time


iDescription

TPtrC iDescription

Description

Description


iDetails

TPtrC iDetails

Description

Details


iError

TInt32 iError

Description

Error


iMtm

TUid iMtm

Description

MTM


iMtmData1

TInt32 iMtmData1

Description

MTM data 1: this can be used for any purpose by an MTM.


iMtmData2

TInt32 iMtmData2

Description

MTM data 2: this can be used for any purpose by an MTM.


iMtmData3

TInt32 iMtmData3

Description

MTM data 3: this can be used for any purpose by an MTM.


iRelatedId

TMsvId iRelatedId

Description

Related folder ID.


iServiceId

TMsvId iServiceId

Description

Service ID.


iSize

TInt32 iSize

Description

Size


iType

TUid iType

Description

Entry type


iWdpPortNumber

TInt32 iWdpPortNumber

Support

Withdrawn in 6.0

Description

Port number


iBioType

TInt32 iBioType

Support

Supported from 6.0

Description

BIO message type