ListMessages Method
Lists the messages in a folder.
Syntax
ANSI (Cross Platform) int ListMessages(const char* lpszfolderId, const char* lpszfilter); Unicode (Windows) INT ListMessages(LPCWSTR lpszfolderId, LPCWSTR lpszfilter);
- (void)listMessages:(NSString*)folderId :(NSString*)filter;
#define MID_OFFICE365_LISTMESSAGES 23 CLOUDMAIL_EXTERNAL int CLOUDMAIL_CALL CloudMail_Office365_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);
Remarks
This method lists the messages found in the specified folder. This method clears and populates the MessageInfo* properties.
If the number of messages is greater than the message page size, ListMessagesMarker will be populated and calling ListMessages again will list the next page of messages.
filter can be used to retrieve a specific subset of messages, or it can be left as an empty string to retrieve all messages in a folder. filter follows the OData protocol syntax.
Example (List All Messages in a Folder)
office365.ListMessages(folderId, "");
Example (List Unread Messages in a Folder)
office365.ListMessages(folderId, "isRead eq false");
Example (List Messages from a Specific Address)
office365.ListMessages(folderId, "address eq 'specific@address.com'");
Example (List Unread Messages from a Specific Address)
office365.ListMessages(folderId, "isRead eq false and address eq 'specific@address.com'");
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.)