DOCUMENT:Q119358  10-NOV-1999  [macmail]
TITLE   :Mac Hyp: Calling MS Mail XFCN from Microsoft FoxPro
PRODUCT :Microsoft Mail For Appletalk Networks
PROD/VER::3.0
OPER/SYS:
KEYWORDS:

======================================================================
-------------------------------------------------------------------------------
The information in this article applies to:

 - Microsoft Mail Software Development Kit (SDK) for HyperCard, version 3.0 
-------------------------------------------------------------------------------

SUMMARY
=======

With Microsoft FoxPro for Macintosh version 2.5, it is possible for developers
to make calls to HyperCard External Functions (XFCNs) and External Commands
(XCMDs). Version 3.x of Microsoft Mail for AppleTalk Networks includes a MS Mail
XFCN that provides HyperCard developers access to AppleTalk Mail. Therefore,
FoxPro developers can create Mail-enabled programs by calling the MS Mail
HyperCard XFCN from FoxPro.

This article defines how to call the MS Mail XFCN from FoxPro.

MORE INFORMATION
================

There are two steps to using the MS Mail XFCN with FoxPro:

 - Creating a Resource file.

 - Writing a Program file.

Creating a Resource File
------------------------

To call an XFCN from Microsoft FoxPro, it is necessary to first create a Resource
file which contains the XFCN and other important resources. This requires a
resource editor like ResEdit. To create the Resource file using ResEdit, do the
following:

1. Make a copy of the Mail Interface Documentation stack, which is included in
   the HyperCard SDK folder on the Extras disk with AppleTalk Mail.

2. Open the copy of the Mail Interface Documentation stack using ResEdit.

3. Double-click the XFCN resource.

4. Select the "msmail" XFCN, ID 200.

5. From the Edit menu, choose Copy.

6. From the File menu, select New. Name the file "MailRes" and click New.

7. From the Edit menu, choose Paste. A new XFCN resource in the MailRes window
   should be created.

8. Switch back to the Mail Interface Documentation window and select the STR#
   resource.

9. From the Edit menu, choose Copy.

10. Activate the MailRes window and select Paste from the Edit menu. A new STR#
   resource will be created.

11. From the File menu, choose Save to save the MailRes file.

12. Quit ResEdit.

Writing the Program File
------------------------

To create the Microsoft FoxPro program file which will call the XFCN, do the
following:

1. Open Microsoft FoxPro.

2. From the File menu, select New.

3. From the list of File Types, select Program and click New.

4. Type the following code in the new Program file:

      *Set the file which contains the XFCN resources
      set xcmdfile to "MailRes"

      *Load the msmail XFCN
      Load msmail function

      *Following are mail calls to create and send a message
      CALL msmail with "getServerName" to serverName
      CALL msmail with "getUserName","TRUE" to myName
      CALL msmail with "createMessage" to theMess
      CALL msmail with "addRecipients", theMess, myName
      CALL msmail with "addSubject", theMess, "Test from FoxPro"
      CALL msmail with "sendMessage", theMess

      *Display server and user name
      ? serverName
      ? myName

      return

5. From the File menu, choose Save to save the Program file.

Testing the Program
-------------------

Before testing the program, be sure that:

1. You are signed into Mail.

2. The FoxPro ".prg" file and the resource file, "MailRes" reside in the same
   folder.

   To test the program, select Do from the Program menu. Locate the ".prg" file
   just created and click the Do button.

Additional query words: 3.00

======================================================================
Keywords          :  
Technology        : kbHWMAC kbOSMAC kbAudDeveloper kbMailSearch kbSDKSearch kbSDKMailHypercard300
Version           : :3.0

=============================================================================

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.

Copyright Microsoft Corporation 1999.