PRB: Creating One-Off Address Causes Application Error

Last reviewed: April 10, 1997
Article ID: Q166503
The information in this article applies to:
  • Extended Messaging Application Programming Interface (MAPI), version 1.0 included with Microsoft Windows Messaging

SYMPTOMS

Address book providers that allow creating One-off addresses get an application error if they do not return MAPI_W_ERRORS_RETURNED as specified by the documentation.

STATUS

This behavior is by design and is not expected to change.

MORE INFORMATION

The following information is an excerpt from the January 1997 version of the Win32 SDK under the topic "IMAPIProp::GetProps":

    Notes to Implementers
    ...
    Return MAPI_W_ERRORS_RETURNED if you cannot retrieve the value for one
    or more of the requested properties. In the property value structure,
    set the type in the ulPropTag member to PT_ERROR and the Value member
    to a status code describing the error.

If you fail to set your return variable for this method to MAPI_W_ERRORS_RETURNED, you are essentially telling MAPI that you support all of the requested properties and they were set without error. MAPI then tries to work with all the expected properties, and when it tries to access a property that is not there, it generates an exception that the client application interprets as an application error, and it then crashes.


Keywords : MAPIIAB
Version : 1.0
Platform : WINDOWS
Issue type : kbprb


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: April 10, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.