Method FindAsync
- Namespace
- MailFathom.Application.Mail.Delivery.Operations
- Assembly
- MailFathom.Application.dll
FindAsync(OutgoingEmailId, CancellationToken)
Reads one send by the identifier every decision names it by, with what each recipient was told.
public Task<OutgoingEmailRecord?> FindAsync(OutgoingEmailId outgoingEmailId, CancellationToken cancellationToken)Parameters
outgoingEmailIdOutgoingEmailIdThe send to read.
cancellationTokenCancellationTokenCancels the read.
Returns
- Task<OutgoingEmailRecord>
The record, or null when this deployment holds no send with that identifier.
Remarks
This is the one reading that names addresses, and it is bounded to one record for that reason: a caller that asks about a specific send by identity is asking about a send they already have in front of them, while a listing that carried the same fields would be an export of somebody's correspondence a page at a time. It is also why the grant is the one every other reading of identified third parties is published under rather than the one its two neighbours share.
Exceptions
- PrincipalNotAuthorizedException
Thrown when the use case was reached by anything but a caller granted AdminAuditRead.
- OperationCanceledException
Thrown when the caller cancels.