PC MAPI: MAPILogon Can Only Be Called Once from an Application

 Last reviewed: May 26, 1995
Article ID: Q130703
The information in this article applies to:
  • Microsoft Mail for PC Networks, versions 3.0 and 3.2

SUMMARY

MAPILogon is a function available with the Simple Messaging Application Program Interface (MAPI), included with Microsoft Mail for PC Networks. MAPILogon is used to validate and create (or increment) the session handle associated with any Microsoft Mail, Microsoft Schedule+, Microsoft Electronic Forms, or Simple MAPI application.

MORE INFORMATION

MAPILogon, once successfully returned, cannot be called again from the same thread of execution, for example, to force the download of new messages during a session. This means that an application making a call to MAPILogon, will not be able to successfully call it again from the same application. If you attempt to make a second call to MAPILogon, you will get the following error: 

   Error 8, MAPI_E_TOO_MANY_SESSIONS
Before you make a second call to MAPILogon, the caller must first call MAPILogout to release the session handle being held by the application.

Additional reference words: 3.20 MAPILogon
KBCategory: kbtool kbprg
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: May 26, 1995
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.