FetchMessageInfo Method

Retrieves information about messages specified by the MessageSet property.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int FetchMessageInfo();

Unicode (Windows)
INT FetchMessageInfo();

- (void)fetchMessageInfo;

#define MID_SIMAP_FETCHMESSAGEINFO 20

IPWORKSSMIME_EXTERNAL int IPWORKSSMIME_CALL IPWorksSMIME_SIMAP_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This method retrieves information for the messages specified by the MessageSet property. This includes information about the message envelope as well as message structure. Every time a message envelope is retrieved, a MessageInfo event is fired, and message envelope information is stored in properties such as: MessageSubject, MessageFrom, MessageRecipients, etc. If the message is a multipart message, one or more MessagePart events are fired before the MessageInfo event - one for each message part.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)