How To Use OLE Messaging to Send Mail in Visual FoxPro App

 Last reviewed: March 5, 1998
Article ID: Q146641
The information in this article applies to:
  • Microsoft Visual FoxPro for Windows, versions 3.0, 3.0b, 5.0

SUMMARY

This article shows by example how you can use OLE Messaging as an alternative to using a MAPI Session and MAPI Messages .ocx controls to send mail. This functionality relies on MAPI OLE Automation support at the operating system level but doesn't require that an .ocx file be added to a form. The MAPI .ocx files currently available use Simple MAPI as opposed to MAPI 1.0, so they are superseded by this.

MORE INFORMATION

The OLE Messaging Library is installed with the MAPI Software Development Kit (SDK). When the OLE Messaging Library is available, the following flag is set in the Win.ini file: 

   [Mail]
   OLEMessaging=1
And it can be found in the registry. Under Windows 95 you will find it in: 

   HKEY_Local_Machine\SOFTWARE\Microsoft\Windows Messaging Subsystem.

Sample Code Showing How to Get This to Work

*==== Beginning of OLE Messaging Program.

SESSION=CREATEOBJECT('mapi.session') && Create the MAPI object. 

SESSION.LOGON                        && Logon to mail; With exchange it
                                     && will prompt for a profile.

NEW=SESSION.OUTBOX.MESSAGES.ADD                   && Create a new message.
NEW.SUBJECT = "Test Mail with OLE Messaging"      && Add a message subject.
NEW.TEXT="Mail System Test"+CHR(13)+"using OLE!" && Actual message text. 

SENDTO=NEW.RECIPIENTS.ADD    && Add a recipient object
SENDTO.NAME="myemailaddr"    && Email address to mail message to
SENDTO.TYPE=1                && 1= "TO:"; 2="CC:"; 3="BCC:"
SENDTO.RESOLVE               && Looks up address in addressbook.

NEW.UPDATE       && Required to save changes to a message object.
NEW.SEND(1,0,0) && Parameter 1 = save copy in "Sent Mail" folder. 
SESSION.LOGOFF   && Release the MAPI object.
*====End of OLE Messaging Program.

REFERENCES

For more details on OLE Messaging, please see the January Microsoft Developers Network (MSDN) CD-ROM compact disc. The Topic is located under the Win32 SDK, Win32 Messaging, and OLE Messaging Library topics.

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

   ARTICLE-ID: Q175052
   TITLE     : HOWTO: Sending a Message in VFP Using Active Messaging

Additional query words: MAPI OLE
Keywords : FxinteropOle vfoxwin OleMsg ActMsg kbcode kbcode kbhowto kbinterop
Version : 3.00 3.00b 5.00
Platform : WINDOWS
Issue type : kbhowto

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