Method ReadAsync

Namespace

MailFathom.Application.Synchronization.Administration

Assembly

MailFathom.Application.dll

ReadAsync(CancellationToken)

Reads the most recent progress of every alias that has any.

Task<IReadOnlyList<MailFolderSynchronizationProgress>> ReadAsync(CancellationToken cancellationToken)

Parameters

cancellationToken CancellationToken

Propagates caller cancellation.

Returns

Task<IReadOnlyList<MailFolderSynchronizationProgress>>

One entry per alias whose progress has moved, ordered ordinally by account and then by alias.

Remarks

An alias no run has ever committed progress for is absent rather than reported empty, because the folders a deployment has are what configuration names and not what this store happens to hold: a caller composes the folder list from configuration and reads an absence here as a folder synchronization has not reached.

It takes no page, because one entry per alias is already the bound. An alias bound to several remote folders over time contributes one entry however many bindings it has, so the size follows the folders an operator has configured over the deployment's life rather than anything a mail server can grow by recreating one.

Exceptions

OperationCanceledException

Thrown when the caller cancels.