IMailFolderStoreAsync(UniqueId, IStoreAnnotationsRequest, CancellationToken) Method

Asynchronously store the annotations for a message.

Definition

Namespace: MailKit
Assembly: MailKit (in MailKit.dll) Version: 5.0.0
C#
Task<bool> StoreAsync(
	UniqueId uid,
	IStoreAnnotationsRequest request,
	CancellationToken cancellationToken = default
)

Parameters

uid  UniqueId
The UID of the message.
request  IStoreAnnotationsRequest
The annotations to store.
cancellationToken  CancellationToken  (Optional)
The cancellation token.

Return Value

TaskBoolean
if the store operation was successful; otherwise, .

Remarks

Asynchronously stores the annotations for a message.

Exceptions

ArgumentException uid is invalid.
ArgumentNullException request is .
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 in read-write mode.
InvalidOperationException Cannot store annotations without any properties defined.
NotSupportedException

The folder does not support annotations.

-or-

The request specified an UnchangedSince value but the folder does not support mod-sequences.
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.

See Also