|
|
/*
* m a p i . h * * Messaging Applications Programming Interface. * * Copyright (c) 1992, 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. */
typedef unsigned long ULONG; typedef unsigned long FAR * LPULONG; typedef unsigned long FLAGS; typedef unsigned long LHANDLE, FAR *LPLHANDLE; #define lhSessionNull ((LHANDLE)0)
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 lpFileType; /* Attachment file type (optional) */ } MapiFileDesc, FAR * lpMapiFileDesc;
#define MAPI_OLE 0x00000001
#define MAPI_OLE_STATIC 0x00000002
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 */ } MapiRecipDesc, 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 */ } MapiMessage, 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_FIFO 0x00000100 /* use date order */
#define MAPI_BODY_AS_FILE 0x00000200
#define MAPI_AB_NOMODIFY 0x00000400 /* Don't allow mods of AB entries */
#define MAPI_SUPPRESS_ATTACH 0x00000800 /* header + body, no files */
#define MAPI_FORCE_DOWNLOAD 0x00001000 /* 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_DENIED 6
#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
#define MAPI_E_INVALID_SESSION 19
#define MAPI_E_TYPE_NOT_SUPPORTED 20
#define MAPI_E_AMBIGUOUS_RECIPIENT 21
#define MAPI_E_MESSAGE_IN_USE 22
#define MAPI_E_NETWORK_FAILURE 23
#define MAPI_E_INVALID_EDITFIELDS 24
#define MAPI_E_INVALID_RECIPS 25
#define MAPI_E_NOT_SUPPORTED 26
|