Click or drag to resize
MimeKit

IMailServiceAuthenticate Method (ICredentials, CancellationToken)

Authenticate using the supplied credentials.

Namespace:  MailKit
Assembly:  MailKit (in MailKit.dll) Version: 2.7.0
Syntax
C#
void Authenticate(
	ICredentials credentials,
	CancellationToken cancellationToken = null
)

Parameters

credentials
Type: System.NetICredentials
The user's credentials.
cancellationToken (Optional)
Type: System.ThreadingCancellationToken
The cancellation token.
Exceptions
ExceptionCondition
ArgumentNullExceptioncredentials is null.
ObjectDisposedException The IMailService has been disposed.
ServiceNotConnectedException The IMailService is not connected.
InvalidOperationException The IMailService is already authenticated.
OperationCanceledException The operation was canceled via the cancellation token.
AuthenticationException Authentication using the supplied credentials has failed.
SaslException A SASL authentication error occurred.
IOException An I/O error occurred.
ProtocolException A protocol error occurred.
Remarks

Authenticates using the supplied credentials.

If the server supports one or more SASL authentication mechanisms, then the SASL mechanisms that both the client and server support are tried in order of greatest security to weakest security. Once a SASL authentication mechanism is found that both client and server support, the credentials are used to authenticate.

If the server does not support SASL or if no common SASL mechanisms can be found, then the default login command is used as a fallback.

See Also