This documentation is archived and is not being maintained.

Application.MailLogon Method

Office 2007
Logs in to MAPI Mail or Microsoft Exchange and establishes a mail session. If Microsoft Mail isn't already running, you must use this method to establish a mail session before mail or document routing functions can be used.


expression.MailLogon(Name, Password, DownloadNewMail)

expression   A variable that represents an Application object.


NameRequired/OptionalData TypeDescription
NameOptionalVariantThe mail account name or Microsoft Exchange profile name. If this argument is omitted, the default mail account name is used.
PasswordOptionalVariantThe mail account password. This argument is ignored in Microsoft Exchange.
DownloadNewMailOptionalVariantTrue to download new mail immediately.


Microsoft Excel logs off any mail sessions it previously established before attempting to establish the new session.

To piggyback on the system default mail session, omit both the name and password parameters.


This example logs in to the default mail account.

Visual Basic for Applications
If IsNull(Application.MailSession) Then
End If