IMail |
public static IList<IMessageSummary> Fetch( this IMailFolder folder, IList<UniqueId> uids, ulong modseq, MessageSummaryItems items, IEnumerable<HeaderId> headers, CancellationToken cancellationToken = default )
Exception | Condition |
---|---|
ArgumentNullException | uids is null. -or- headers is null. |
ArgumentException | One or more of the uids is invalid. -or- One or more of the specified headers is invalid. |
ObjectDisposedException | The IMailStore has been disposed. |
ServiceNotConnectedException | The IMailStore is not connected. |
ServiceNotAuthenticatedException | The IMailStore is not authenticated. |
FolderNotOpenException | The folder is not currently open. |
OperationCanceledException | The operation was canceled via the cancellation token. |
IOException | An I/O error occurred. |
ProtocolException | The server's response contained unexpected tokens. |
CommandException | The command failed. |
Fetches the message summaries for the specified message UIDs that have a higher mod-sequence value than the one specified.
If the mail store supports quick resynchronization and the application has enabled this feature via EnableQuickResync(CancellationToken), then this method will emit MessagesVanished events for messages that have vanished since the specified mod-sequence value.
It should be noted that if another client has modified any message in the folder, the mail service may choose to return information that was not explicitly requested. It is therefore important to be prepared to handle both additional fields on a IMessageSummary for messages that were requested as well as summaries for messages that were not requested at all.