MAPI.H

/* 
 *  m a p i . h 
 *     
 *  Messaging Applications Programming Interface. 
 *     
 *  Copyright 1992 - 1998 Microsoft Corporation.  All rights reserved. 
 *     
 *  Purpose: 
 *    This file defines the structures and constants used by 
 *    that subset of the messaging applications programming 
 *    interface which will be supported under Windows by 
 *    Microsoft Mail for PC Networks vesion 3.0. 
 */ 
 
 
 
/* 
 *  Types. 
 */ 
 
#ifdef __cplusplus 
extern "C" { 
#endif 
 
typedef unsigned long       ULONG; 
typedef unsigned long FAR * LPULONG; 
typedef unsigned long       FLAGS; 
typedef unsigned longLHANDLE, FAR *LPLHANDLE; 
#define lhSessionNull   ((LHANDLE)0) 
 
 
#define MAPI_MESSAGEID_LENGTH   64 
 
typedef struct 
  { 
    ULONG ulReserved;    // Reserved for future use (must be 0) 
ULONG flFlags; // Flags 
    ULONG nPosition;     // character in text to be replaced by attachment 
    LPSTR lpszPathName;  // Full path name of attachment file 
    LPSTR lpszFileName;  // Original file name (optional) 
    LPVOID  UNALIGNED lpFileType;   // Attachment file type (optional) 
  } UNALIGNED MapiFileDesc, UNALIGNED FAR * lpMapiFileDesc; 
 
#defineMAPI_OLE0x00000001 
#defineMAPI_OLE_STATIC0x00000002 
 
 
 
 
typedef struct 
  { 
    ULONG ulReserved;           // Reserved for future use 
    ULONG ulRecipClass;         // Recipient class 
                                // MAPI_TO, MAPI_CC, MAPI_BCC, MAPI_ORIG 
    LPSTR lpszName;             // Recipient name 
    LPSTR lpszAddress;          // Recipient address (optional) 
    ULONG ulEIDSize;        // Count in bytes of size of pEntryID 
    LPVOID lpEntryID;           // System-specific recipient reference 
  } UNALIGNED MapiRecipDesc, UNALIGNED FAR * lpMapiRecipDesc; 
 
#define MAPI_ORIG   0           // Recipient is message originator 
#define MAPI_TO     1           // Recipient is a primary recipient 
#define MAPI_CC     2           // Recipient is a copy recipient 
#define MAPI_BCC    3           // Recipient is blind copy recipient 
 
 
 
typedef struct 
  { 
    ULONG ulReserved;                   // Reserved for future use (M.B. 0) 
    LPSTR lpszSubject;                  // Message Subject 
    LPSTR lpszNoteText;                 // Message Text 
    LPSTR lpszMessageType;              // Message Class 
    LPSTR lpszDateReceived;             // in YYYY/MM/DD HH:MM format    
LPSTR lpszConversationID;// conversation thread ID 
    FLAGS flFlags;                      // unread,return receipt 
    lpMapiRecipDesc lpOriginator;       // Originator descriptor 
    ULONG nRecipCount;                  // Number of recipients 
    lpMapiRecipDesc lpRecips;           // Recipient descriptors 
    ULONG nFileCount;                   // # of file attachments 
    lpMapiFileDesc lpFiles;             // Attachment descriptors 
  } UNALIGNED MapiMessage, UNALIGNED FAR * lpMapiMessage; 
 
#define MAPI_UNREAD             0x00000001 
#define MAPI_RECEIPT_REQUESTED  0x00000002 
#define MAPI_SENT               0x00000004 
 
 
 
/* 
 *  Entry points. 
 */ 
 
 
 
#define MAPI_LOGON_UI                   0x00000001  // Display logon UI 
#define MAPI_NEW_SESSION                0x00000002  // Do not use default. 
#define MAPI_DIALOG                     0x00000008  // Display a send note UI 
#define MAPI_UNREAD_ONLY                0x00000020  // Only unread messages 
#define MAPI_ENVELOPE_ONLY              0x00000040  // Only header information 
#define MAPI_PEEK                       0x00000080  // Do not mark as read. 
#define MAPI_GUARANTEE_FIFO0x00000100// use date order 
#defineMAPI_BODY_AS_FILE0x00000200 
#define MAPI_AB_NOMODIFY0x00000400// Don't allow mods of AB entries 
#defineMAPI_SUPPRESS_ATTACH0x00000800// header + body, no files 
#defineMAPI_FORCE_DOWNLOAD0x00001000// force download of new mail during MAPILogon 
 
ULONG FAR PASCAL MAPILogon(ULONG ulUIParam, LPSTR lpszName, LPSTR lpszPassword, 
                           FLAGS flFlags, ULONG ulReserved, 
                           LPLHANDLE lplhSession); 
 
ULONG FAR PASCAL MAPILogoff(LHANDLE lhSession, ULONG ulUIParam, FLAGS flFlags, 
                            ULONG ulReserved); 
 
ULONG FAR PASCAL MAPISendMail(LHANDLE lhSession, ULONG ulUIParam, 
                              lpMapiMessage lpMessage, FLAGS flFlags, 
                              ULONG ulReserved); 
 
ULONG FAR PASCAL MAPISendDocuments(ULONG ulUIParam, LPSTR lpszDelimChar, 
                                   LPSTR lpszFilePaths, LPSTR lpszFileNames, 
                                   ULONG ulReserved); 
 
ULONG FAR PASCAL MAPIFindNext(LHANDLE lhSession, ULONG ulUIParam, 
                              LPSTR lpszMessageType, LPSTR lpszSeedMessageID, 
                              FLAGS flFlags, ULONG ulReserved, 
                              LPSTR lpszMessageID); 
 
ULONG FAR PASCAL MAPIReadMail(LHANDLE lhSession, ULONG ulUIParam, 
                              LPSTR lpszMessageID, FLAGS flFlags, 
                              ULONG ulReserved, lpMapiMessage FAR *lppMessageOut); 
 
ULONG FAR PASCAL MAPISaveMail(LHANDLE lhSession, ULONG ulUIParam, 
                              lpMapiMessage pMessage, FLAGS flFlags, 
                              ULONG ulReserved, LPSTR lpszMessageID); 
 
ULONG FAR PASCAL MAPIDeleteMail(LHANDLE lhSession, ULONG ulUIParam, 
                                LPSTR lpszMessageID, FLAGS flFlags, 
                                ULONG ulReserved); 
 
ULONG FAR PASCAL MAPIFreeBuffer( LPVOID pv ); 
 
ULONG FAR PASCAL MAPIAddress(LHANDLE lhSession, ULONG ulUIParam, 
LPSTR plszCaption, ULONG nEditFields, 
LPSTR lpszLabels, ULONG nRecips, 
lpMapiRecipDesc lpRecips, FLAGS flFlags, ULONG ulReserved,  
LPULONG lpnNewRecips, lpMapiRecipDesc FAR *lppNewRecips); 
 
ULONG FAR PASCAL MAPIDetails(LHANDLE lhSession, ULONG ulUIParam, 
lpMapiRecipDesc lpRecip, FLAGS flFlags, ULONG ulReserved); 
 
ULONG FAR PASCAL MAPIResolveName(LHANDLE lhSession, ULONG ulUIParam, 
LPSTR lpszName, FLAGS flFlags, 
ULONG ulReserved, lpMapiRecipDesc FAR *lppRecip); 
 
 
 
#define SUCCESS_SUCCESS                     0 
#define MAPI_USER_ABORT                     1 
#define MAPI_E_FAILURE                      2 
#define MAPI_E_LOGIN_FAILURE                3 
#define MAPI_E_DISK_FULL                    4 
#define MAPI_E_INSUFFICIENT_MEMORY          5 
#define MAPI_E_ACCESS_DENIED6 
#define MAPI_E_TOO_MANY_SESSIONS            8 
#define MAPI_E_TOO_MANY_FILES               9 
#define MAPI_E_TOO_MANY_RECIPIENTS          10 
#define MAPI_E_ATTACHMENT_NOT_FOUND         11 
#define MAPI_E_ATTACHMENT_OPEN_FAILURE      12 
#define MAPI_E_ATTACHMENT_WRITE_FAILURE     13 
#define MAPI_E_UNKNOWN_RECIPIENT            14 
#define MAPI_E_BAD_RECIPTYPE                15 
#define MAPI_E_NO_MESSAGES                  16 
#define MAPI_E_INVALID_MESSAGE              17 
#define MAPI_E_TEXT_TOO_LARGE               18 
#defineMAPI_E_INVALID_SESSION19 
#defineMAPI_E_TYPE_NOT_SUPPORTED20 
#defineMAPI_E_AMBIGUOUS_RECIPIENT21 
#define MAPI_E_MESSAGE_IN_USE22 
#define MAPI_E_NETWORK_FAILURE23 
#defineMAPI_E_INVALID_EDITFIELDS24 
#defineMAPI_E_INVALID_RECIPS25 
#defineMAPI_E_NOT_SUPPORTED26 
 
#ifdef __cplusplus 
} 
#endif