RDOSyncMessageItem object

 

RDOSyncMessageItem object represents a changed message (added/modified/deleted) in a folder .

 

Returned by:

RDOSyncMessagesCollection.Item

 

See RDOFolderSynchronizer for an example.

 

Derived from: IDispatch

Properties

ChangeKey

String, read-only. Returns the value of the PR_CHANGE_KEY property.

 

  

EntryID

String, read-only, Returns the value of the entry id (PR_ENTRYID) of the message. The value is a combination of the source key (PR_SOURCE_KEY) of the message and its parent folder.

 

  
Fields[PropTag]
 Returns the property value of a property (identified by the PropTag parameter) provided directly by the ICS API without having to open the message itself (Item property)
 set Session = CreateObject("Redemption.RDOSession")
Session.MAPIOBJECT = Application.Session.MAPIOBJECT
set Folder = Session.GetFolderfromID(Application.ActiveExplorer.CurrentFolder.EntryID, , _
                                                                 MAPI_BEST_ACCESS or MAPI_NO_CACHE)
set Synchonizer = Folder.ExchangeSynchonizer
set SyncItems = Synchonizer.SyncItems("", "")
for each Item in SyncItems
    Debug.Print "------------------"
    Debug.Print Item.Item.Subject
    set proplist = Item.PropList
    for i = 1 to proplist .Count
        propTag = proplist [i]
        Debug.Print "0x" & Hex(propTag) & ": " & Item.Fields(propTag)
    next
next

IsNewMessage

boolean. read-only. True if this is a newly added message, false otherwise.

This property is valid only if Kind = sikChanged.

 

 

Item

RDOMail, read-only. Returns the corresponding message. Note that an exception will be raised for the deleted items (Kind = sikDeleted)

 

 

Kind

rdoSyncItemKind, Read-only. Returns the kind of the modification.

To distinguish between new messages and modified existing messages (in both cases Kind = sikChanged), use the IsNewMessage property (see above).

 

sikChanged = 0
sikDeleted = 1
sikReadStatusChanged = 2

 

 

LastModificationTime

DateTime, read-only. Returns the time of the modification, corresponds to the PR_LAST_MODIFICATION_TIME property.

 

 
PropList
 Returns IPropList collection of the MAPI property tags of the properties provided directly by the ICS API during the sync

 see Fields example above

SourceKey

String, read-only. Returns the value of the PR_SOURCE_KEY property uniquely identifying the message.

Also see RDOExchangeStore.GetMessageFromSourceKey