Contents of WGREADME.TXT, the Workgroup Extensions Readme

• Microsoft FoxPro for Windows, version 2.6

SUMMARY

Below is the complete FoxPro for Windows WGREADME.TXT file, found on Disk 1 of the WorkGroup Extensions Kit, or the WorkGroup Extensions subdirectory (normally FPW26\WRKEXTS)

MORE INFORMATION

                      WGREADME.TXT

  Microsoft(R) FoxPro(R) Version 2.6 Professional Edition

                 WorkGroup Extensions

    (C)1994 Microsoft Corporation. All Rights Reserved.

CONTENTS

Part Description ---- -----------

 1     Introduction
 2     Installation
 3     Notes About Sample Applications
 4     Distributing Applications to Users
 5     Using MAPI in Interactive Mode

Part 1: Introduction This Readme contains details about installing and using the FoxPro MAPI functions in FOXMAPI.FLL to integrate Microsoft FoxPro for Windows with Microsoft Mail and Microsoft Schedule+. For information on specific functions, see the Help file (FOXMAPI.HLP) located in the WRKEXTS directory. The Help file can also be accessed by selecting FoxPro MAPI Help... from the Mail menu sample program.

Before you begin using the FoxPro MAPI routines, it is recommended that you review the "FoxPro Environmental Considerations" Help topic.

Part 2: Installation

Installing the Professional Edition of FoxPro 2.6

Distribution Kit Connectivity Kit Library Construction Kit WorkGroup Extensions (FoxPro for Windows only)

To install the Professional Edition of FoxPro, first install the main FoxPro product, then follow the installation instructions included with each individual kit. The order in which the kits are installed does not matter.

Installing the WorkGroup Extensions

1. Create a new subdirectory of your main FoxPro directory and name the subdirectory WRKEXTS.

2. Copy the following files from the floppy disk to the WRKEXTS directory:

   FOXMAPI.FLL FOXMAPI.HLP REQUIRED.DBF README.TXT TO_PRINT.RTF

3. Copy the following subdirectories and their contents from the floppy disk to the WRKEXTS directory:

   LIBS SAMPLES

4. Copy the following files from the subdirectory LIBS to the Microsoft Windows system directory (usually called WINDOWS\SYSTEM):

   MAPI.DLL SPLUS.DLL

Part 3: Notes about Sample Applications The FoxPro sample programs and applications are distributed solely to provide examples and guidelines for using the FOXMAPI library calls. Microsoft is not responsible for the code contained in any of the sample files and does not provide support for these files.

The sample programs contain examples of all 12 MAPI functions contained in the FoxPro MAPI library, FOXMAPI.FLL.

The Library Routines in MAPILIB.PRG

Each of the sample applications use a common log on routine in MAPILIB which checks to see if there is an active MS Mail session running, and then uses it for transactions. For information about how to run multiple sessions of MS Mail, see the Help file.

The Mail Menu

All 12 MAPI calls are included in the two main programs used in this sample application, READMAIL.PRG and SENDMAIL.PRG. The majority of the calls are contained in the READMAIL program which goes through and polls your MS Mail Inbox messages. You should review this code closely as it contains several tricks for successfully handing MS Mail messages in FoxPro.

Bulk Mailing Application

Note: The FoxPro tables contain place holder MS Mail names and addressees. Running the application without modifying these names and addresses produces an "Unknown Recipient" error. To run the application, you should use names and addresses contained in your MS Mail system.

Using this sample application you can send two types of mail messages to a list of people contained in a FoxPro table: General and Personal.

If you select the General radio button, a single message is sent to all mail addresses contained in the table. All names are included in To box, and the Send Note dialog appears to confirm the mailing.

If you select the Personalized radio button, each recipient receives an individual copy of the message. Only one name is included in the To box, and the Send Note dialog is suppressed. This mailing takes more time since a message is sent for each individual in the listing. In the code of the personalized mailing, notice how you can set flags to suppress the MAPI SendNote dialog.

Project File Updater Application

This sample program illustrates two MAPI uses: how to send files to others, and how to send a MAPI message which does not get detected by MS Mail.

The interface provides a popup menu with all the developers working on the project. The developer names and files they are working with are located in two tables. Being a developer, you would select your name from the popup, and all the files assigned to you are placed in a list box. Use the Move button to select files to update to the other developer's machines.

The Mail Files button creates a message with only the updated files. No text is added to the message. For purposes of identifying these mail messages, the subject field is stamped with 'Project Files' and message type field is stamped as 'IPC.ProjectUpdater'. The IPC type will not be detected by the MS Mail client (it will not appear in the Inbox).

The Receive Files button polls through the mail looking for files stamped with a type "IPC.ProjectUpdater" and subject "Project Files". A cursor table is created showing a list of these files. Note: Files are not actually updated (i.e., overwritten) in the sample program.

Note: The FoxPro table contains place holder MS Mail names and addressees. Running the application without modifying these names and addresses produces an "Unknown Recipient" error. To run the application, you should use names and addresses contained in your MS Mail system.

Schedule+ Sample Programs

Part 4: Distributing Applications to Users For information about distributing applications to users, see the topic "Distributing Your WorkGroup Applications" in the Help file.

To help you distribute applications, compressed versions of the MAPI.DLL and SPLUS.DLL libraries are included with the WorkGroup Extensions in the LIBS subdirectory. These files are named MAPI.DL_ and SPLUS.DL_.

The compressed MAPI.DL_ library is the United States version 3.02, and the SPLUS.DL_ library is version 1.0a. If you use updated or international versions of these files, or you later receive updated versions, distribute your updated or new international files to your users.

The MAPI.DL_ and SPLUS.L_ files are provided for the convenience of you and your users. Each user must have a valid client license for Microsoft Mail, Microsoft Schedule+, or Microsoft Windows for WorkGroups. You cannot distribute these libraries to unlicensed users.

Distributing Library Files outside of the United States

Part 5: Using MAPI in Interactive Mode If you type a MAPI command into the FoxPro Command Window or use the keyboard to select a button that calls a MAPI command, and that particular MAPI command brings up a MS Mail dialogue box (i.e. MPSendNote), the cursor may not appear. However, the cursor will appear if the code is run programmatically.

                     ===================
                     END OF WGREADME.TXT
                     ===================