Constructor MailFolderSynchronizationProgress

Namespace

MailFathom.Application.Synchronization.Administration

Assembly

MailFathom.Application.dll

MailFolderSynchronizationProgress(MailFolderIdentity, ImapUidValidity, ImapUid?, DateTimeOffset)

How far one folder's durable synchronization progress has come, and when it last moved.

public MailFolderSynchronizationProgress(MailFolderIdentity Folder, ImapUidValidity UidValidity, ImapUid? LastSeenUid, DateTimeOffset AdvancedAt)

Parameters

Folder MailFolderIdentity

The account and alias the progress belongs to.

UidValidity ImapUidValidity

The UID space the progress was made in, which changes when a mail server recreates the folder.

LastSeenUid ImapUid?

The newest UID the forward pass has durably processed, or null when the space is empty.

AdvancedAt DateTimeOffset

When the progress last moved.

Remarks

This is the half of a folder's status that survives a restart, and the half that separates a folder with nothing left to fetch from one that has been repeating the same batch. A run that fails before committing leaves the instant where it was, so an alias whose progress last moved a day ago while its runs keep ending is stuck rather than quiet.

An alias can have been bound to several remote folders over time and each binding keeps progress of its own. What is reported is the binding that moved most recently, because the older ones describe a UID space the mail server has already renumbered away from.