178 lines
6.9 KiB
C
178 lines
6.9 KiB
C
|
/*
|
||
|
|
* m a p i . h
|
||
|
|
*
|
||
|
|
* Messaging Applications Programming Interface.
|
||
|
|
*
|
||
|
|
* Copyright (c) 1992-1993, 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.2.
|
||
|
|
*/
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
/*
|
||
|
|
* 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 */
|
||
|
|
LPTSTR lpszPathName; /* Full path name of attachment file */
|
||
|
|
LPTSTR 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 */
|
||
|
|
LPTSTR lpszName; /* Recipient name */
|
||
|
|
LPTSTR 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) */
|
||
|
|
LPTSTR lpszSubject; /* Message Subject */
|
||
|
|
LPTSTR lpszNoteText; /* Message Text */
|
||
|
|
LPTSTR lpszMessageType; /* Message Class */
|
||
|
|
LPTSTR lpszDateReceived; /* in YYYY/MM/DD HH:MM format */
|
||
|
|
LPTSTR 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, LPTSTR lpszName, LPTSTR 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, LPTSTR lpszDelimChar,
|
||
|
|
LPTSTR lpszFilePaths, LPTSTR lpszFileNames,
|
||
|
|
ULONG ulReserved);
|
||
|
|
|
||
|
|
ULONG FAR PASCAL MAPIFindNext(LHANDLE lhSession, ULONG ulUIParam,
|
||
|
|
LPTSTR lpszMessageType, LPTSTR lpszSeedMessageID,
|
||
|
|
FLAGS flFlags, ULONG ulReserved,
|
||
|
|
LPTSTR lpszMessageID);
|
||
|
|
|
||
|
|
ULONG FAR PASCAL MAPIReadMail(LHANDLE lhSession, ULONG ulUIParam,
|
||
|
|
LPTSTR lpszMessageID, FLAGS flFlags,
|
||
|
|
ULONG ulReserved, lpMapiMessage FAR *lppMessageOut);
|
||
|
|
|
||
|
|
ULONG FAR PASCAL MAPISaveMail(LHANDLE lhSession, ULONG ulUIParam,
|
||
|
|
lpMapiMessage pMessage, FLAGS flFlags,
|
||
|
|
ULONG ulReserved, LPTSTR lpszMessageID);
|
||
|
|
|
||
|
|
ULONG FAR PASCAL MAPIDeleteMail(LHANDLE lhSession, ULONG ulUIParam,
|
||
|
|
LPTSTR lpszMessageID, FLAGS flFlags,
|
||
|
|
ULONG ulReserved);
|
||
|
|
|
||
|
|
ULONG FAR PASCAL MAPIFreeBuffer( LPVOID pv );
|
||
|
|
|
||
|
|
ULONG FAR PASCAL MAPIAddress(LHANDLE lhSession, ULONG ulUIParam,
|
||
|
|
LPTSTR plszCaption, ULONG nEditFields,
|
||
|
|
LPTSTR 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,
|
||
|
|
LPTSTR 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
|