PC MAPI: Suppressing the Default Logon Dialog Box

 Last reviewed: July 2, 1997
Article ID: Q135704
3.00 3.20 WINDOWS kbtool

The information in this article applies to:

  • Microsoft Mail for PC Networks, versions 3.0 and 3.2

SUMMARY

When you use the MSMAPI.VBX control to logon Mail for PC Networks, you can suppress the default logon dialog box by setting the following:

  • The LogonUI property of MapiSession to false.
  • The Username property to a valid mailbox.
  • The Password to the mailbox's password.

However, when the password property is null, the following error will occur: 

   2003 (Login Failure)

MORE INFORMATION

Make sure that the entries for the user's name and password are present in the MSMAIL.INI.

NOTE: The Password entry does not need any characters after it. 

   [Microsoft Mail]
   Login=username
   Password=
The code below duplicates the situation when the error occurs with the Admin mailbox and a blank password. 

   myform.MapiSess.UserName = "admin"
   myform.MapiSess.Password = ""
   myform.MapiSess.NewSession = True
   myform.MapiSess.LogonUI = False
   myform.MapiSess.Action = SESSION_SIGNON
Unfortunately, a null password can be used only if there is an existing session or the LogonUI property is set to True. If there is an existing session, you can pass nulls for both the name and password, and you will be returned a handle to the existing session. If there is no existing session, and you set LogonUI property to true, MAPILogon will generate the standard Sign-In dialog box.

Additional reference words 3.00 3.20 Visual Basic blank MAPI_LOGON_UI

KBCategory: kbtool
KBSubcategory: MailPCMAPI

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: July 2, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.