Using uid or messageId to locate email

[oleung]

Hi,

 

I am new to 360Works Email Plugin. This is very useful on retrieving email from the server.

 

I have some difficulty on understanding the document. 

 

On using the function EmailReadMessages to move the pointer to the starting email to pull in, I am a bit frustrate on when to use uid and messageId.

 

I can use uid to move the pointer to the last email before calling the EmailGetNextMessage to call the next available email message. This works well... but i can never use messageId to do the same thing. Am I missing out some important concept here? 

 

There are some other parameter for filtering like "from", "to", "subject" and even "body". What are they? How can I use them to filter the message list before I can use the EmailGetNextMessage function.

 

So far, I am using the "uid" as the parameter for EmailReadMessages with success but not others.

 

 

Thanks.

Oli

[domiller]

Message-ID doesn't work like UID.  UID is a per-account number assigned by the mail server, and will change if messages are moved to a different server.  It is expected to be unique and always incrementing within an individual account, thus the ability to retrieve newer messages based on uid.

 

Message-id, on the other hand, is a unique string generated by the message creator.  It is expected to be universally unique, but you may *not* expect it to be incrementing, or, in fact, make any assumptions about it at all other than its uniqueness.  It should be of the form <somestring>@<hostname>, but not all mailers are strict about this.

 

RFC822 says: This field contains a unique identifier (the local-part address unit) which refers to THIS version of THIS message. The uniqueness of the message identifier is guaranteed by the host which generates it. This identifier is intended to be machine readable and not necessarily meaningful to humans. A message identifier pertains to exactly one instantiation of a particular message; subsequent revisions to the message should each receive new message identifiers.

 

Thus , if you know a particular Message-ID (or a particular pattern), you can use this option to retrive messages, but it can't be used to grab arbritary groups in the same way that UID can.