Microsoft KB Archive/123185

{|
 * width="100%"|

GP Fault Using MAPI.DLL Calls in Visual Basic Procedure

 * }

Q123185

-

The information in this article applies to:


 * Microsoft Visual Basic for Applications version 1.0
 * Microsoft Excel for Windows, versions 5.0, 5.0c
 * Microsoft Project for Windows, version 4.0

-

SYMPTOMS
In a Microsoft Visual Basic, Applications Edition, procedure, when you call the MAPI.DLL in a Visual Basic procedure, you receive a general protection (GP) fault.

CAUSE
Although it is possible to declare and call the Visual Basic MAPI functions from a Visual Basic procedure in Microsoft Excel or Microsoft Project, the calls usually cause a GP Fault.

You cannot use MAPI functions from a Visual Basic procedure in Microsoft Excel or Microsoft Project in the form that is documented for use with Visual Basic version 3.0. NOTE: The MAPI calls that fail are the calls that use custom Type definitions (MAPIMessage, MAPIRecip, or MAPIFile). Other calls that don't use a custom Type (such as MAPILogon and MAPISendDocuments) may work correctly.

Microsoft Project
To work around this problem, you can use the VBAMAPI.DLL file that is provided with Microsoft Project. This file provides the same Visual Basic interfaces to MAPI in a form that is compatible with Visual Basic, Applications Edition.

Note that you can also use the built-in mail functionality provided in Microsoft Project. For example, you can use the following in a Visual Basic procedure:

MailLogOff method

MailLogOn method

MailRoutingSlip method

MailSend method

MailSendProjectMail method

MailSendScheduleNote method

MailSession property

MailSystem property

MailUpdateProject method

Microsoft Excel
To work around this problem, use the built-in mail functionality provided in Microsoft Excel. For example, you can use the following in a Visual Basic procedure:

MailLogoff method

MailLogon method

MailSession property

MailSystem property

SendMail method

MORE INFORMATION
Messaging Application Programming Interface (MAPI) is the standard programming interface proposed and supported by Microsoft for accessing electronic messaging.

The following MAPI.DLL functions do not cause a GP fault when you use them in a Visual Basic, Applications Edition, procedure:

MAPILogon

MAPILogoff

MAPIDetails

MAPISendDocuments

MAPIDeleteMail You receive a GP fault when you call any of the following MAPI.DLL functions in a Visual Basic, Applications Edition, procedure:

MAPIResolveName

MAPIFindNext

MAPIAddress

MAPISaveMail

MAPISendMail

MAPIReadMail For additional information, please see the following articles in the Microsoft Knowledge Base:

Q125854 XL: Sending Mail From Microsoft Excel using VBAMAPI.DLL (Part 1)

Q125853 XL: Sending Mail From Microsoft Excel using VBAMAPI.DLL (Part 2)