readme.mapi

email client and support pop3、smtp、imap protocol.

This is a small code for forwarding mails from POP3 postbox to MSMail.
USE AT YOUR OWN RISK.This has been written using CMC (Common Messaging Calls).
The codes have to be included with InterServer and compiled.I have tested this
with MSMail but should work with any CMC enabled messaging services. Some part
of main InetServer code have been modified for testing & implementing.
Please forward bug reports to [e-mail].


Requirement for running:-
~~~~~~~~~~~~~~~~~~~~~~~~~
The program uses MAPI DLLs ( bundled with all Windows95/NT )

1. Valid MSMail User,Exchange_Profile,password. Currently hard coded as "InetGate" & "ipsmail"    on ProcessPOP32MAPI()
   a. create a new user called InetGate in your MSMail postoffice.
   b. create a new profile (InetGate) called InetGate in your Win95/WinNT
   All mails will be forwarded as mail from InetGate to Respective User.
   SMTP From address will be added to Mail Message.

2. New directory for  storing all mails that needs to be forwarded.
    eg: C:\InetServer\cmcqueue

2. New file called mapifwd.ctl storing all POP3 & MSMail users
        eg :
        <user_name>            eg:- yasin               ( POP3 User )
        <mapi_user_name>       eg:- Mohammed Yasin      ( MSMail Alias )
        <mapi_user_address>    eg:- MS:APAINTS/APBHP/yasin ( MSMail Address )
        <user_name>            eg:- abc
        <mapi_user_name>       eg:- Test Mail user
        <mapi_user_address>    eg:- MS:APAINTS/APBHP/test

3. All mails that needs to be transfered should be moved to new directory
   called "cmcqueue".  InetServerDlg.cpp has been modified to do this automatically
   with user list.
4. The envelop should start with 1.MSMail user list  ( used by mapi forwarding code )
                                 2.Mail Header   ( SMTP mail header )
                                 3.Mail Body     ( SMTP Message Body )
   eg:-
        X-CMC_TO:<username>;<useraddress>; ( one record per line )
                eg: X-CMC_TO:Mohamed Yasin;MS:APAINTS/APBHP/yasin;
        X-CMCEND ( indicates end of mapi address used while parsing in POP2CMC)
        ...... ( mail header )
        <ctrlf> ( blank line )
        .....  ( message )
        <ctrlf>.<ctrlf> ( end of mail envelop)
   InetServerDlg.cpp has been modified to do this automatically.


Limitation:-
~~~~~~~~~~~~
1. Supports only base64 decoding for attachment
2. Supports only 16 file attachment ( More than 16 will be ignored )
3. Supports only 16 mapi addresses per mail
4. Cannot run as Service ( Some MSMail gateway says documented bug exist )


Modified/Added File on Inetserv:-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1. Wrap2cmc.cpp         -- (NEW) wrapper class defnition for CMC calls
2. Wrap2cmc.h           -- (NEW) wrapper class declaration for CMC calls
3. Pop2cmc.cpp          -- (NEW) mapi forwarding class defnition
4. Pop2cmc.h            -- (NEW) mapi forwarding class declaration
5. cmcutil.h            -- (NEW) datatype declaration
6. base64.h             -- (NEW) Base64 encoding/decoding taken from public domain
6. base64.cpp           -- (NEW) Base64 encoding/decoding taken from public domain
8. InetServerApp.cpp    -- all mapi specific variable/code/function commented with //- MAPI
                           a. initialisation code & gets addressess of CMC function
9. InetServerDlg.h      -- all mapi specific variable/code/function commented with //- MAPI
                           a. new class to pop3user & mapiuser link     
10. InetServerDlg.cpp    -- all mapi sepcific variable/code/function commented with //- MAPI
                           a. (NEW) array to stores pop3user & mapiuser link      
                           b. InetServerDlg::ProcessNewMail() modified to update mail envelop for mapi forwarding
                           c. CAboutDlg::OnReg() modified to update mapi-enabled flag in registry
                           d. (NEW) InetServerDlg::ProcessPOP32CMC() logs onto mapi and sends the mail error trapping doesn't happen
                           e. InetServerDlg::OnPop3() for building pop3-mapi user link


TODO:-
~~~~~~
1. Add other Decoding schemes
2. Identify To,Cc,Bcc and process accordingly
3. Add MSMail to SMTP forwarding
4. Proper error trappings    
5. Parameterise Exchange_Profile & Password 
6. Proper documentation ??
7. Add MSExchange forwarding  ( current code might work )