开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 游戏 > 模拟服务器 > 查看源码
WabDefs.h
资源名称：SwordOnline.rar　[点击查看]
上传用户：dzyhzl
上传日期：2019-04-29
资源大小：56270k
文件大小：101k
源码类别：

模拟服务器

开发平台：

C/C++

WabDefs.h：源码内容
  1. /*
  2.  *  WABDEFS.H
  3.  *
  4.  *  Definitions used by WAB clients
  5.  *
  6.  *  Copyright 1993-1998 Microsoft Corporation. All Rights Reserved.
  7.  */
  9. #ifdef WIN16
  10. #ifdef GetLastError
  11. #undef GetLastError
  12. #endif // GetLastError
  13. #endif // WIN16
  15. #if !defined(MAPIDEFS_H) && !defined(WABDEFS_H)
  16. #define WABDEFS_H
  17. #if defined (WIN32)
  19. #if defined (NT) && !defined (_WINNT)
  20. #pragma message ("nWARNING!!n NT defined but not _WINNT.n    You must define _WINNT to ensure "
  21.     "successful compile of Windows NT coden")
  22. #define _WINNT
  23. #endif /* defined NT and not defined _WINNT */
  24. #endif /* WIN32 */
  26. #if defined (WIN32) && !defined (MAC)   /* Must include WINDOWS.H on Win32 */
  27. #ifndef _WINDOWS_
  28. #define INC_OLE2 /* Get the OLE2 stuff */
  29. #define INC_RPC  /* harmless on Windows NT; Windows 95 needs it */
  30. #define _INC_OLE /* Windows 95 will include OLE1 without this */
  31. #include <windows.h>
  32. #endif
  34. #ifndef _OLEERROR_H_
  35. #include <objerror.h>
  36. #endif
  37. #ifndef _OBJBASE_H_
  38. #include <objbase.h>
  39. #endif
  40. #endif
  42. #if defined (WIN16) || defined (DOS) || defined (DOS16) || defined (MAC)
  43. #ifndef _COMPOBJ_H_
  44. #include <compobj.h>
  45. #endif
  46. #endif
  48. #ifndef _INC_STDDEF
  49. #include <stddef.h>
  50. #endif
  52. /* Array dimension for structures with variable-sized arrays at the end. */
  54. #ifndef MAPI_DIM
  55. #define MAPI_DIM    1
  56. #endif
  58. /* Provider init type. Force to cdecl always */
  60. #ifndef STDMAPIINITCALLTYPE
  61. #if !defined (_MAC) && defined (WIN32)
  62. #define STDMAPIINITCALLTYPE     __cdecl
  63. #else
  64. #define STDMAPIINITCALLTYPE     STDMETHODCALLTYPE
  65. #endif
  66. #define STDINITMETHODIMP        HRESULT STDMAPIINITCALLTYPE
  67. #define STDINITMETHODIMP_(type) type STDMAPIINITCALLTYPE
  68. #endif
  70. #ifdef  __cplusplus
  71. extern "C" {
  72. #endif
  74. /* Simple data types */
  77. #if !defined(UNIX) && !defined(WIN16)
  78. typedef WORD                WCHAR;
  79. #endif
  81. #ifdef UNICODE
  82. typedef WCHAR               TCHAR;
  83. #else
  84. typedef char                TCHAR;
  85. #endif
  87. typedef WCHAR FAR *         LPWSTR;
  88. typedef const WCHAR FAR *   LPCWSTR;
  89. typedef TCHAR FAR *         LPTSTR;
  90. typedef const TCHAR FAR *   LPCTSTR;
  91. typedef BYTE FAR *          LPBYTE;
  92. typedef ULONG FAR *         LPULONG;
  94. #ifndef __LHANDLE
  95. #define __LHANDLE
  96. typedef unsigned long   LHANDLE, FAR * LPLHANDLE;
  97. #endif
  99. #if !defined(_WINBASE_) && !defined(_FILETIME_)
  100. #define _FILETIME_
  101. typedef struct _FILETIME
  102. {
  103.     DWORD dwLowDateTime;
  104.     DWORD dwHighDateTime;
  105. } FILETIME, FAR * LPFILETIME;
  106. #endif
  108. #ifndef BEGIN_INTERFACE
  109. #define BEGIN_INTERFACE
  110. #endif
  112. /*
  113.  *  This flag is used in many different MAPI calls to signify that
  114.  *  the object opened by the call should be modifiable (MAPI_MODIFY).
  115.  *  If the flag MAPI_MAX_ACCESS is set, the object returned should be
  116.  *  returned at the maximum access level allowed.  An additional
  117.  *  property available on the object (PR_ACCESS_LEVEL) uses the same
  118.  *  MAPI_MODIFY flag to say just what this new access level is.
  119.  */
  121. #define MAPI_MODIFY             ((ULONG) 0x00000001)
  123. /*
  124.  *  The following flags are used to indicate to the client what access
  125.  *  level is permissible in the object. They appear in PR_ACCESS in
  126.  *  message and folder objects as well as in contents and associated
  127.  *  contents tables
  128.  */
  130. #define MAPI_ACCESS_MODIFY                  ((ULONG) 0x00000001)
  131. #define MAPI_ACCESS_READ                    ((ULONG) 0x00000002)
  132. #define MAPI_ACCESS_DELETE                  ((ULONG) 0x00000004)
  133. #define MAPI_ACCESS_CREATE_HIERARCHY        ((ULONG) 0x00000008)
  134. #define MAPI_ACCESS_CREATE_CONTENTS         ((ULONG) 0x00000010)
  135. #define MAPI_ACCESS_CREATE_ASSOCIATED       ((ULONG) 0x00000020)
  137. /*
  138.  *  The MAPI_UNICODE flag is used in many different MAPI calls to signify
  139.  *  that strings passed through the interface are in Unicode (a 16-bit
  140.  *  character set). The default is an 8-bit character set.
  141.  *
  142.  *  The value fMapiUnicode can be used as the 'normal' value for
  143.  *  that bit, given the application's default character set.
  144.  */
  146. #define MAPI_UNICODE            ((ULONG) 0x80000000)
  148. #ifdef UNICODE
  149. #define fMapiUnicode            MAPI_UNICODE
  150. #else
  151. #define fMapiUnicode            0
  152. #endif
  154. /* successful HRESULT */
  155. #define hrSuccess               0
  159. /* Recipient types */
  160. #ifndef MAPI_ORIG               /* also defined in mapi.h */
  161. #define MAPI_ORIG   0           /* Recipient is message originator          */
  162. #define MAPI_TO     1           /* Recipient is a primary recipient         */
  163. #define MAPI_CC     2           /* Recipient is a copy recipient            */
  164. #define MAPI_BCC    3           /* Recipient is blind copy recipient        */
  165. #define MAPI_P1     0x10000000  /* Recipient is a P1 resend recipient       */
  166. #define MAPI_SUBMITTED 0x80000000 /* Recipient is already processed         */
  167. /* #define MAPI_AUTHORIZE 4        recipient is a CMC authorizing user      */
  168. /*#define MAPI_DISCRETE 0x10000000 Recipient is a P1 resend recipient       */
  169. #endif
  171. /* Bit definitions for abFlags[0] of ENTRYID */
  172. #define MAPI_SHORTTERM          0x80
  173. #define MAPI_NOTRECIP           0x40
  174. #define MAPI_THISSESSION        0x20
  175. #define MAPI_NOW                0x10
  176. #define MAPI_NOTRESERVED        0x08
  178. /* Bit definitions for abFlags[1] of ENTRYID */
  179. #define MAPI_COMPOUND           0x80
  181. /* ENTRYID */
  182. typedef struct
  183. {
  184.     BYTE    abFlags[4];
  185.     BYTE    ab[MAPI_DIM];
  186. } ENTRYID, FAR *LPENTRYID;
  188. #define CbNewENTRYID(_cb)       (offsetof(ENTRYID,ab) + (_cb))
  189. #define CbENTRYID(_cb)          (offsetof(ENTRYID,ab) + (_cb))
  190. #define SizedENTRYID(_cb, _name) 
  191.     struct _ENTRYID_ ## _name 
  192. { 
  193.     BYTE    abFlags[4]; 
  194.     BYTE    ab[_cb]; 
  195. } _name
  197. /* Byte-order-independent version of GUID (world-unique identifier) */
  198. typedef struct _MAPIUID
  199. {
  200.     BYTE ab[16];
  201. } MAPIUID, FAR * LPMAPIUID;
  203. /* Note:  need to include C run-times (memory.h) to use this macro */
  205. #define IsEqualMAPIUID(lpuid1, lpuid2)  (!memcmp(lpuid1, lpuid2, sizeof(MAPIUID)))
  208. /* Object type */
  210. #define MAPI_STORE      ((ULONG) 0x00000001)    /* Message Store */
  211. #define MAPI_ADDRBOOK   ((ULONG) 0x00000002)    /* Address Book */
  212. #define MAPI_FOLDER     ((ULONG) 0x00000003)    /* Folder */
  213. #define MAPI_ABCONT     ((ULONG) 0x00000004)    /* Address Book Container */
  214. #define MAPI_MESSAGE    ((ULONG) 0x00000005)    /* Message */
  215. #define MAPI_MAILUSER   ((ULONG) 0x00000006)    /* Individual Recipient */
  216. #define MAPI_ATTACH     ((ULONG) 0x00000007)    /* Attachment */
  217. #define MAPI_DISTLIST   ((ULONG) 0x00000008)    /* Distribution List Recipient */
  218. #define MAPI_PROFSECT   ((ULONG) 0x00000009)    /* Profile Section */
  219. #define MAPI_STATUS     ((ULONG) 0x0000000A)    /* Status Object */
  220. #define MAPI_SESSION    ((ULONG) 0x0000000B)    /* Session */
  221. #define MAPI_FORMINFO   ((ULONG) 0x0000000C)    /* Form Information */
  224. /*
  225.  *  Maximum length of profile names and passwords, not including
  226.  *  the null termination character.
  227.  */
  228. #ifndef cchProfileNameMax
  229. #define cchProfileNameMax   64
  230. #define cchProfilePassMax   64
  231. #endif
  234. /* Property Types */
  236. #define MV_FLAG         0x1000          /* Multi-value flag */
  238. #define PT_UNSPECIFIED  ((ULONG)  0)    /* (Reserved for interface use) type doesn't matter to caller */
  239. #define PT_NULL         ((ULONG)  1)    /* NULL property value */
  240. #define PT_I2           ((ULONG)  2)    /* Signed 16-bit value */
  241. #define PT_LONG         ((ULONG)  3)    /* Signed 32-bit value */
  242. #define PT_R4           ((ULONG)  4)    /* 4-byte floating point */
  243. #define PT_DOUBLE       ((ULONG)  5)    /* Floating point double */
  244. #define PT_CURRENCY     ((ULONG)  6)    /* Signed 64-bit int (decimal w/    4 digits right of decimal pt) */
  245. #define PT_APPTIME      ((ULONG)  7)    /* Application time */
  246. #define PT_ERROR        ((ULONG) 10)    /* 32-bit error value */
  247. #define PT_BOOLEAN      ((ULONG) 11)    /* 16-bit boolean (non-zero true) */
  248. #define PT_OBJECT       ((ULONG) 13)    /* Embedded object in a property */
  249. #define PT_I8           ((ULONG) 20)    /* 8-byte signed integer */
  250. #define PT_STRING8      ((ULONG) 30)    /* Null terminated 8-bit character string */
  251. #define PT_UNICODE      ((ULONG) 31)    /* Null terminated Unicode string */
  252. #define PT_SYSTIME      ((ULONG) 64)    /* FILETIME 64-bit int w/ number of 100ns periods since Jan 1,1601 */
  253. #define PT_CLSID        ((ULONG) 72)    /* OLE GUID */
  254. #define PT_BINARY       ((ULONG) 258)   /* Uninterpreted (counted byte array) */
  255. /* Changes are likely to these numbers, and to their structures. */
  257. /* Alternate property type names for ease of use */
  258. #define PT_SHORT    PT_I2
  259. #define PT_I4       PT_LONG
  260. #define PT_FLOAT    PT_R4
  261. #define PT_R8       PT_DOUBLE
  262. #define PT_LONGLONG PT_I8
  264. /*
  265.  *  The type of a MAPI-defined string property is indirected, so
  266.  *  that it defaults to Unicode string on a Unicode platform and to
  267.  *  String8 on an ANSI or DBCS platform.
  268.  *
  269.  *  Macros are defined here both for the property type, and for the
  270.  *  field of the property value structure which should be
  271.  *  dereferenced to obtain the string pointer.
  272.  */
  274. #ifdef  UNICODE
  275. #define PT_TSTRING          PT_UNICODE
  276. #define PT_MV_TSTRING       (MV_FLAG|PT_UNICODE)
  277. #define LPSZ                lpszW
  278. #define LPPSZ               lppszW
  279. #define MVSZ                MVszW
  280. #else
  281. #define PT_TSTRING          PT_STRING8
  282. #define PT_MV_TSTRING       (MV_FLAG|PT_STRING8)
  283. #define LPSZ                lpszA
  284. #define LPPSZ               lppszA
  285. #define MVSZ                MVszA
  286. #endif
  289. /* Property Tags
  290.  *
  291.  * By convention, MAPI never uses 0 or FFFF as a property ID.
  292.  * Use as null values, initializers, sentinels, or what have you.
  293.  */
  295. #define PROP_TYPE_MASK          ((ULONG)0x0000FFFF) /* Mask for Property type */
  296. #define PROP_TYPE(ulPropTag)    (((ULONG)(ulPropTag))&PROP_TYPE_MASK)
  297. #define PROP_ID(ulPropTag)      (((ULONG)(ulPropTag))>>16)
  298. #define PROP_TAG(ulPropType,ulPropID)   ((((ULONG)(ulPropID))<<16)|((ULONG)(ulPropType)))
  299. #define PROP_ID_NULL            0
  300. #define PROP_ID_INVALID         0xFFFF
  301. #define PR_NULL                 PROP_TAG( PT_NULL, PROP_ID_NULL)
  302. #define CHANGE_PROP_TYPE(ulPropTag, ulPropType) 
  303.                         (((ULONG)0xFFFF0000 & ulPropTag) | ulPropType)
  306. /* Multi-valued Property Types */
  308. #define PT_MV_I2        (MV_FLAG|PT_I2)
  309. #define PT_MV_LONG      (MV_FLAG|PT_LONG)
  310. #define PT_MV_R4        (MV_FLAG|PT_R4)
  311. #define PT_MV_DOUBLE    (MV_FLAG|PT_DOUBLE)
  312. #define PT_MV_CURRENCY  (MV_FLAG|PT_CURRENCY)
  313. #define PT_MV_APPTIME   (MV_FLAG|PT_APPTIME)
  314. #define PT_MV_SYSTIME   (MV_FLAG|PT_SYSTIME)
  315. #define PT_MV_STRING8   (MV_FLAG|PT_STRING8)
  316. #define PT_MV_BINARY    (MV_FLAG|PT_BINARY)
  317. #define PT_MV_UNICODE   (MV_FLAG|PT_UNICODE)
  318. #define PT_MV_CLSID     (MV_FLAG|PT_CLSID)
  319. #define PT_MV_I8        (MV_FLAG|PT_I8)
  321. /* Alternate property type names for ease of use */
  322. #define PT_MV_SHORT     PT_MV_I2
  323. #define PT_MV_I4        PT_MV_LONG
  324. #define PT_MV_FLOAT     PT_MV_R4
  325. #define PT_MV_R8        PT_MV_DOUBLE
  326. #define PT_MV_LONGLONG  PT_MV_I8
  328. /*
  329.  *  Property type reserved bits
  330.  *
  331.  *  MV_INSTANCE is used as a flag in table operations to request
  332.  *  that a multi-valued property be presented as a single-valued
  333.  *  property appearing in multiple rows.
  334.  */
  336. #define MV_INSTANCE     0x2000
  337. #define MVI_FLAG        (MV_FLAG | MV_INSTANCE)
  338. #define MVI_PROP(tag)   ((tag) | MVI_FLAG)
  340. /* --------------- */
  341. /* Data Structures */
  342. /* --------------- */
  344. /* Property Tag Array */
  346. typedef struct _SPropTagArray
  347. {
  348.     ULONG   cValues;
  349.     ULONG   aulPropTag[MAPI_DIM];
  350. } SPropTagArray, FAR * LPSPropTagArray;
  352. #define CbNewSPropTagArray(_ctag) 
  353.     (offsetof(SPropTagArray,aulPropTag) + (_ctag)*sizeof(ULONG))
  354. #define CbSPropTagArray(_lparray) 
  355.     (offsetof(SPropTagArray,aulPropTag) + 
  356.     (UINT)((_lparray)->cValues)*sizeof(ULONG))
  357. /*  SPropTagArray */
  358. #define SizedSPropTagArray(_ctag, _name) 
  359. struct _SPropTagArray_ ## _name 
  360. { 
  361.     ULONG   cValues; 
  362.     ULONG   aulPropTag[_ctag]; 
  363. } _name
  365. /* -------------- */
  366. /* Property Value */
  367. /* -------------- */
  369. typedef struct _SPropValue  SPropValue;
  372. /* 32-bit CURRENCY definition stolen from oaidl.h */
  373. /* 16-bit CURRENCY definition stolen from variant.h */
  375. #ifndef _tagCY_DEFINED
  376. #define _tagCY_DEFINED
  377. #define _CY_DEFINED
  378. #if (defined (WIN16) || defined (DOS)) && !defined (_VARIANT_H_)
  379. typedef struct FARSTRUCT tagCY {
  380. #ifdef _MAC
  381.         long      Hi;
  382.         long Lo;
  383. #else
  384.         unsigned long Lo;
  385.         long      Hi;
  386. #endif
  387. } CY;
  388. #elif defined (WIN32)
  389. /* real definition that makes the C++ compiler happy */
  390. typedef union tagCY {
  391.     struct {
  392. #ifdef _MAC
  393.         long      Hi;
  394.         long Lo;
  395. #else
  396.         unsigned long Lo;
  397.         long      Hi;
  398. #endif
  399.     };
  400.     LONGLONG int64;
  401. } CY;
  402. #endif /* 16-bit vs 32-bit definition */
  403. #endif
  404.             /* size is 8 */
  405. typedef CY CURRENCY;
  407. typedef struct _SBinary
  408. {
  409.     ULONG       cb;
  410.     LPBYTE      lpb;
  411. } SBinary, FAR *LPSBinary;
  413. typedef struct _SShortArray
  414. {
  415.     ULONG       cValues;
  416.     short int   FAR *lpi;
  417. } SShortArray;
  419. typedef struct _SGuidArray
  420. {
  421.     ULONG       cValues;
  422.     GUID        FAR *lpguid;
  423. } SGuidArray;
  425. typedef struct _SRealArray
  426. {
  427.     ULONG       cValues;
  428.     float       FAR *lpflt;
  429. } SRealArray;
  431. typedef struct _SLongArray
  432. {
  433.     ULONG       cValues;
  434.     LONG        FAR *lpl;
  435. } SLongArray;
  437. typedef struct _SLargeIntegerArray
  438. {
  439.     ULONG       cValues;
  440.     LARGE_INTEGER   FAR *lpli;
  441. } SLargeIntegerArray;
  443. typedef struct _SDateTimeArray
  444. {
  445.     ULONG       cValues;
  446.     FILETIME    FAR *lpft;
  447. } SDateTimeArray;
  449. typedef struct _SAppTimeArray
  450. {
  451.     ULONG       cValues;
  452.     double      FAR *lpat;
  453. } SAppTimeArray;
  455. typedef struct _SCurrencyArray
  456. {
  457.     ULONG       cValues;
  458.     CURRENCY    FAR *lpcur;
  459. } SCurrencyArray;
  461. typedef struct _SBinaryArray
  462. {
  463.     ULONG       cValues;
  464.     SBinary     FAR *lpbin;
  465. } SBinaryArray;
  467. typedef struct _SDoubleArray
  468. {
  469.     ULONG       cValues;
  470.     double      FAR *lpdbl;
  471. } SDoubleArray;
  473. typedef struct _SWStringArray
  474. {
  475.     ULONG       cValues;
  476.     LPWSTR      FAR *lppszW;
  477. } SWStringArray;
  479. typedef struct _SLPSTRArray
  480. {
  481.     ULONG       cValues;
  482.     LPSTR       FAR *lppszA;
  483. } SLPSTRArray;
  485. typedef union _PV
  486. {
  487.     short int           i;          /* case PT_I2 */
  488.     LONG                l;          /* case PT_LONG */
  489.     ULONG               ul;         /* alias for PT_LONG */
  490.     float               flt;        /* case PT_R4 */
  491.     double              dbl;        /* case PT_DOUBLE */
  492.     unsigned short int  b;          /* case PT_BOOLEAN */
  493.     CURRENCY            cur;        /* case PT_CURRENCY */
  494.     double              at;         /* case PT_APPTIME */
  495.     FILETIME            ft;         /* case PT_SYSTIME */
  496.     LPSTR               lpszA;      /* case PT_STRING8 */
  497.     SBinary             bin;        /* case PT_BINARY */
  498.     LPWSTR              lpszW;      /* case PT_UNICODE */
  499.     LPGUID              lpguid;     /* case PT_CLSID */
  500.     LARGE_INTEGER       li;         /* case PT_I8 */
  501.     SShortArray         MVi;        /* case PT_MV_I2 */
  502.     SLongArray          MVl;        /* case PT_MV_LONG */
  503.     SRealArray          MVflt;      /* case PT_MV_R4 */
  504.     SDoubleArray        MVdbl;      /* case PT_MV_DOUBLE */
  505.     SCurrencyArray      MVcur;      /* case PT_MV_CURRENCY */
  506.     SAppTimeArray       MVat;       /* case PT_MV_APPTIME */
  507.     SDateTimeArray      MVft;       /* case PT_MV_SYSTIME */
  508.     SBinaryArray        MVbin;      /* case PT_MV_BINARY */
  509.     SLPSTRArray         MVszA;      /* case PT_MV_STRING8 */
  510.     SWStringArray       MVszW;      /* case PT_MV_UNICODE */
  511.     SGuidArray          MVguid;     /* case PT_MV_CLSID */
  512.     SLargeIntegerArray  MVli;       /* case PT_MV_I8 */
  513.     SCODE               err;        /* case PT_ERROR */
  514.     LONG                x;          /* case PT_NULL, PT_OBJECT (no usable value) */
  515. } __UPV;
  517. typedef struct _SPropValue
  518. {
  519.     ULONG       ulPropTag;
  520.     ULONG       dwAlignPad;
  521.     union _PV   Value;
  522. } SPropValue, FAR * LPSPropValue;
  525. /* --------------------------------------------- */
  526. /* Property Problem and Property Problem Arrays */
  527. /* --------------------------------------------- */
  529. typedef struct _SPropProblem
  530. {
  531.     ULONG   ulIndex;
  532.     ULONG   ulPropTag;
  533.     SCODE   scode;
  534. } SPropProblem, FAR * LPSPropProblem;
  536. typedef struct _SPropProblemArray
  537. {
  538.     ULONG           cProblem;
  539.     SPropProblem    aProblem[MAPI_DIM];
  540. } SPropProblemArray, FAR * LPSPropProblemArray;
  542. #define CbNewSPropProblemArray(_cprob) 
  543.     (offsetof(SPropProblemArray,aProblem) + (_cprob)*sizeof(SPropProblem))
  544. #define CbSPropProblemArray(_lparray) 
  545.     (offsetof(SPropProblemArray,aProblem) + 
  546.     (UINT) ((_lparray)->cProblem*sizeof(SPropProblem)))
  547. #define SizedSPropProblemArray(_cprob, _name) 
  548. struct _SPropProblemArray_ ## _name 
  549. { 
  550.     ULONG           cProblem; 
  551.     SPropProblem    aProblem[_cprob]; 
  552. } _name
  554. /*
  555.  *  ENTRYLIST
  556.  */
  558. typedef SBinaryArray ENTRYLIST, FAR *LPENTRYLIST;
  560. /*
  561.  *  FLATENTRYLIST
  562.  *  MTSID
  563.  *  FLATMTSIDLIST
  564.  */
  566. typedef struct {
  567.     ULONG cb;
  568.     BYTE abEntry[MAPI_DIM];
  569. } FLATENTRY, FAR *LPFLATENTRY;
  571. typedef struct {
  572.     ULONG       cEntries;
  573.     ULONG       cbEntries;
  574.     BYTE        abEntries[MAPI_DIM];
  575. } FLATENTRYLIST, FAR *LPFLATENTRYLIST;
  577. typedef struct {
  578.     ULONG       cb;
  579.     BYTE        ab[MAPI_DIM];
  580. } MTSID, FAR *LPMTSID;
  582. typedef struct {
  583.     ULONG       cMTSIDs;
  584.     ULONG       cbMTSIDs;
  585.     BYTE        abMTSIDs[MAPI_DIM];
  586. } FLATMTSIDLIST, FAR *LPFLATMTSIDLIST;
  588. #define CbNewFLATENTRY(_cb)     (offsetof(FLATENTRY,abEntry) + (_cb))
  589. #define CbFLATENTRY(_lpentry)   (offsetof(FLATENTRY,abEntry) + (_lpentry)->cb)
  590. #define CbNewFLATENTRYLIST(_cb) (offsetof(FLATENTRYLIST,abEntries) + (_cb))
  591. #define CbFLATENTRYLIST(_lplist) (offsetof(FLATENTRYLIST,abEntries) + (_lplist)->cbEntries)
  592. #define CbNewMTSID(_cb)         (offsetof(MTSID,ab) + (_cb))
  593. #define CbMTSID(_lpentry)       (offsetof(MTSID,ab) + (_lpentry)->cb)
  594. #define CbNewFLATMTSIDLIST(_cb) (offsetof(FLATMTSIDLIST,abMTSIDs) + (_cb))
  595. #define CbFLATMTSIDLIST(_lplist) (offsetof(FLATMTSIDLIST,abMTSIDs) + (_lplist)->cbMTSIDs)
  596. /* No SizedXXX macros for these types. */
  598. /* ------------------------------ */
  599. /* ADRENTRY, ADRLIST */
  601. typedef struct _ADRENTRY
  602. {
  603.     ULONG           ulReserved1;    /* Never used */
  604.     ULONG           cValues;
  605.     LPSPropValue    rgPropVals;
  606. } ADRENTRY, FAR * LPADRENTRY;
  608. typedef struct _ADRLIST
  609. {
  610.     ULONG           cEntries;
  611.     ADRENTRY        aEntries[MAPI_DIM];
  612. } ADRLIST, FAR * LPADRLIST;
  614. #define CbNewADRLIST(_centries) 
  615.     (offsetof(ADRLIST,aEntries) + (_centries)*sizeof(ADRENTRY))
  616. #define CbADRLIST(_lpadrlist) 
  617.     (offsetof(ADRLIST,aEntries) + (UINT)(_lpadrlist)->cEntries*sizeof(ADRENTRY))
  618. #define SizedADRLIST(_centries, _name) 
  619. struct _ADRLIST_ ## _name 
  620. { 
  621.     ULONG           cEntries; 
  622.     ADRENTRY        aEntries[_centries]; 
  623. } _name
  625. /* ------------------------------ */
  626. /* SRow, SRowSet */
  628. typedef struct _SRow
  629. {
  630.     ULONG           ulAdrEntryPad;  /* Pad so SRow's can map to ADRENTRY's */
  631.     ULONG           cValues;        /* Count of property values */
  632.     LPSPropValue    lpProps;        /* Property value array */
  633. } SRow, FAR * LPSRow;
  635. typedef struct _SRowSet
  636. {
  637.     ULONG           cRows;          /* Count of rows */
  638.     SRow            aRow[MAPI_DIM]; /* Array of rows */
  639. } SRowSet, FAR * LPSRowSet;
  641. #define CbNewSRowSet(_crow)     (offsetof(SRowSet,aRow) + (_crow)*sizeof(SRow))
  642. #define CbSRowSet(_lprowset)    (offsetof(SRowSet,aRow) + 
  643.                                     (UINT)((_lprowset)->cRows*sizeof(SRow)))
  644. #define SizedSRowSet(_crow, _name) 
  645. struct _SRowSet_ ## _name 
  646. { 
  647.     ULONG           cRows; 
  648.     SRow            aRow[_crow]; 
  649. } _name
  651. /* MAPI Allocation Routines ------------------------------------------------ */
  653. typedef SCODE (STDMETHODCALLTYPE ALLOCATEBUFFER)(
  654.     ULONG           cbSize,
  655.     LPVOID FAR *    lppBuffer
  656. );
  658. typedef SCODE (STDMETHODCALLTYPE ALLOCATEMORE)(
  659.     ULONG           cbSize,
  660.     LPVOID          lpObject,
  661.     LPVOID FAR *    lppBuffer
  662. );
  664. typedef ULONG (STDAPICALLTYPE FREEBUFFER)(
  665.     LPVOID          lpBuffer
  666. );
  668. typedef ALLOCATEBUFFER FAR *LPALLOCATEBUFFER;
  669. typedef ALLOCATEMORE FAR *  LPALLOCATEMORE;
  670. typedef FREEBUFFER FAR *    LPFREEBUFFER;
  672. /* MAPI Component Object Model Macros -------------------------------------- */
  674. #if defined(MAPI_IF) && (!defined(__cplusplus) || defined(CINTERFACE))
  675. #define DECLARE_MAPI_INTERFACE(iface)                                   
  676.         typedef struct iface##Vtbl iface##Vtbl, FAR * iface;            
  677.         struct iface##Vtbl
  678. #define DECLARE_MAPI_INTERFACE_(iface, baseiface)                       
  679.         DECLARE_MAPI_INTERFACE(iface)
  680. #define DECLARE_MAPI_INTERFACE_PTR(iface, piface)                       
  681.         typedef struct iface##Vtbl iface##Vtbl, FAR * iface, FAR * FAR * piface;
  682. #else
  683. #define DECLARE_MAPI_INTERFACE(iface)                                   
  684.         DECLARE_INTERFACE(iface)
  685. #define DECLARE_MAPI_INTERFACE_(iface, baseiface)                       
  686.         DECLARE_INTERFACE_(iface, baseiface)
  687. #ifdef __cplusplus
  688. #define DECLARE_MAPI_INTERFACE_PTR(iface, piface)                       
  689.         interface iface; typedef iface FAR * piface
  690. #else
  691. #define DECLARE_MAPI_INTERFACE_PTR(iface, piface)                       
  692.         typedef interface iface iface, FAR * piface
  693. #endif
  694. #endif
  696. #define MAPIMETHOD(method)              MAPIMETHOD_(HRESULT, method)
  697. #define MAPIMETHOD_(type, method)       STDMETHOD_(type, method)
  698. #define MAPIMETHOD_DECLARE(type, method, prefix) 
  699.         STDMETHODIMP_(type) prefix##method
  700. #define MAPIMETHOD_TYPEDEF(type, method, prefix) 
  701.         typedef type (STDMETHODCALLTYPE prefix##method##_METHOD)
  703. #define MAPI_IUNKNOWN_METHODS(IPURE)                                    
  704.     MAPIMETHOD(QueryInterface)                                          
  705.         (THIS_ REFIID riid, LPVOID FAR * ppvObj) IPURE;                 
  706.     MAPIMETHOD_(ULONG,AddRef)  (THIS) IPURE;                            
  707.     MAPIMETHOD_(ULONG,Release) (THIS) IPURE;                            
  709. #undef  IMPL
  710. #define IMPL
  712. /* Pointers to MAPI Interfaces --------------------------------------------- */
  714. typedef const IID FAR * LPCIID;
  716. DECLARE_MAPI_INTERFACE_PTR(IMsgStore,       LPMDB);
  717. DECLARE_MAPI_INTERFACE_PTR(IMAPIFolder,     LPMAPIFOLDER);
  718. DECLARE_MAPI_INTERFACE_PTR(IMessage,        LPMESSAGE);
  719. DECLARE_MAPI_INTERFACE_PTR(IAttach,         LPATTACH);
  720. DECLARE_MAPI_INTERFACE_PTR(IAddrBook,       LPADRBOOK);
  721. DECLARE_MAPI_INTERFACE_PTR(IABContainer,    LPABCONT);
  722. DECLARE_MAPI_INTERFACE_PTR(IMailUser,       LPMAILUSER);
  723. DECLARE_MAPI_INTERFACE_PTR(IDistList,       LPDISTLIST);
  724. DECLARE_MAPI_INTERFACE_PTR(IMAPIStatus,     LPMAPISTATUS);
  725. DECLARE_MAPI_INTERFACE_PTR(IMAPITable,      LPMAPITABLE);
  726. DECLARE_MAPI_INTERFACE_PTR(IProfSect,       LPPROFSECT);
  727. DECLARE_MAPI_INTERFACE_PTR(IMAPIProp,       LPMAPIPROP);
  728. DECLARE_MAPI_INTERFACE_PTR(IMAPIContainer,  LPMAPICONTAINER);
  729. DECLARE_MAPI_INTERFACE_PTR(IMAPIAdviseSink, LPMAPIADVISESINK);
  730. DECLARE_MAPI_INTERFACE_PTR(IMAPIProgress,   LPMAPIPROGRESS);
  731. DECLARE_MAPI_INTERFACE_PTR(IProviderAdmin,  LPPROVIDERADMIN);
  733. /* Extended MAPI Error Information ----------------------------------------- */
  735. typedef struct _MAPIERROR
  736. {
  737.     ULONG   ulVersion;
  738.     LPTSTR  lpszError;
  739.     LPTSTR  lpszComponent;
  740.     ULONG   ulLowLevelError;
  741.     ULONG   ulContext;
  743. } MAPIERROR, FAR * LPMAPIERROR;
  746. /* IMAPIAdviseSink Interface ----------------------------------------------- */
  748. /*
  749.  *  Notification event types. The event types can be combined in a bitmask
  750.  *  for filtering. Each one has a parameter structure associated with it:
  751.  *
  752.  *      fnevCriticalError       ERROR_NOTIFICATION
  753.  *      fnevNewMail             NEWMAIL_NOTIFICATION
  754.  *      fnevObjectCreated       OBJECT_NOTIFICATION
  755.  *      fnevObjectDeleted       OBJECT_NOTIFICATION
  756.  *      fnevObjectModified      OBJECT_NOTIFICATION
  757.  *      fnevObjectCopied        OBJECT_NOTIFICATION
  758.  *      fnevSearchComplete      OBJECT_NOTIFICATION
  759.  *      fnevTableModified       TABLE_NOTIFICATION
  760.  *      fnevStatusObjectModified OBJECT_NOTIFICATION
  761.  *
  762.  *      fnevExtended            EXTENDED_NOTIFICATION
  763.  */
  765. #define fnevCriticalError           ((ULONG) 0x00000001)
  766. #define fnevNewMail                 ((ULONG) 0x00000002)
  767. #define fnevObjectCreated           ((ULONG) 0x00000004)
  768. #define fnevObjectDeleted           ((ULONG) 0x00000008)
  769. #define fnevObjectModified          ((ULONG) 0x00000010)
  770. #define fnevObjectMoved             ((ULONG) 0x00000020)
  771. #define fnevObjectCopied            ((ULONG) 0x00000040)
  772. #define fnevSearchComplete          ((ULONG) 0x00000080)
  773. #define fnevTableModified           ((ULONG) 0x00000100)
  774. #define fnevStatusObjectModified    ((ULONG) 0x00000200)
  775. #define fnevReservedForMapi         ((ULONG) 0x40000000)
  776. #define fnevExtended                ((ULONG) 0x80000000)
  778. /* TABLE_NOTIFICATION event types passed in ulTableEvent */
  780. #define TABLE_CHANGED       1
  781. #define TABLE_ERROR         2
  782. #define TABLE_ROW_ADDED     3
  783. #define TABLE_ROW_DELETED   4
  784. #define TABLE_ROW_MODIFIED  5
  785. #define TABLE_SORT_DONE     6
  786. #define TABLE_RESTRICT_DONE 7
  787. #define TABLE_SETCOL_DONE   8
  788. #define TABLE_RELOAD        9
  790. /* Event Structures */
  792. typedef struct _ERROR_NOTIFICATION
  793. {
  794.     ULONG       cbEntryID;
  795.     LPENTRYID   lpEntryID;
  796.     SCODE       scode;
  797.     ULONG       ulFlags;            /* 0 or MAPI_UNICODE */
  798.     LPMAPIERROR lpMAPIError;        /* Detailed error information */
  799. } ERROR_NOTIFICATION;
  801. typedef struct _NEWMAIL_NOTIFICATION
  802. {
  803.     ULONG       cbEntryID;
  804.     LPENTRYID   lpEntryID;          /* identifies the new message */
  805.     ULONG       cbParentID;
  806.     LPENTRYID   lpParentID;         /* identifies the folder it lives in */
  807.     ULONG       ulFlags;            /* 0 or MAPI_UNICODE */
  808.     LPTSTR      lpszMessageClass;   /* message class (UNICODE or string8) */
  809.     ULONG       ulMessageFlags;     /* copy of PR_MESSAGE_FLAGS */
  810. } NEWMAIL_NOTIFICATION;
  812. typedef struct _OBJECT_NOTIFICATION
  813. {
  814.     ULONG               cbEntryID;
  815.     LPENTRYID           lpEntryID;      /* EntryID of object */
  816.     ULONG               ulObjType;      /* Type of object */
  817.     ULONG               cbParentID;
  818.     LPENTRYID           lpParentID;     /* EntryID of parent object */
  819.     ULONG               cbOldID;
  820.     LPENTRYID           lpOldID;        /* EntryID of old object */
  821.     ULONG               cbOldParentID;
  822.     LPENTRYID           lpOldParentID;  /* EntryID of old parent */
  823.     LPSPropTagArray     lpPropTagArray;
  824. } OBJECT_NOTIFICATION;
  826. typedef struct _TABLE_NOTIFICATION
  827. {
  828.     ULONG               ulTableEvent;   /* Identifies WHICH table event */
  829.     HRESULT             hResult;        /* Value for TABLE_ERROR */
  830.     SPropValue          propIndex;      /* This row's "index property" */
  831.     SPropValue          propPrior;      /* Preceding row's "index property" */
  832.     SRow                row;            /* New data of added/modified row */
  833.     ULONG               ulPad;          /* Force to 8-byte boundary */
  834. } TABLE_NOTIFICATION;
  836. typedef struct _EXTENDED_NOTIFICATION
  837. {
  838.     ULONG       ulEvent;                    /* extended event code */
  839.     ULONG       cb;                         /* size of event parameters */
  840.     LPBYTE      pbEventParameters;          /* event parameters */
  841. } EXTENDED_NOTIFICATION;
  843. typedef struct
  844. {
  845.     ULONG           cbEntryID;
  846.     LPENTRYID       lpEntryID;
  847.     ULONG           cValues;
  848.     LPSPropValue    lpPropVals;
  849. } STATUS_OBJECT_NOTIFICATION;
  851. typedef struct _NOTIFICATION
  852. {
  853.     ULONG   ulEventType;        /* notification type, i.e. fnevSomething */
  854.     ULONG   ulAlignPad;         /* Force to 8-byte boundary */
  855.     union
  856.     {
  857.         ERROR_NOTIFICATION          err;
  858.         NEWMAIL_NOTIFICATION        newmail;
  859.         OBJECT_NOTIFICATION         obj;
  860.         TABLE_NOTIFICATION          tab;
  861.         EXTENDED_NOTIFICATION       ext;
  862.         STATUS_OBJECT_NOTIFICATION  statobj;
  863.     } info;
  864. } NOTIFICATION, FAR * LPNOTIFICATION;
  867. /* Interface used for registering and issuing notification callbacks. */
  869. #define MAPI_IMAPIADVISESINK_METHODS(IPURE)                             
  870.     MAPIMETHOD_(ULONG, OnNotify)                                        
  871.         (THIS_  ULONG                       cNotif,                     
  872.                 LPNOTIFICATION              lpNotifications) IPURE;     
  874. #undef       INTERFACE
  875. #define      INTERFACE  IMAPIAdviseSink
  876. DECLARE_MAPI_INTERFACE_(IMAPIAdviseSink, IUnknown)
  877. {
  878.     BEGIN_INTERFACE
  879.     MAPI_IUNKNOWN_METHODS(PURE)
  880.     MAPI_IMAPIADVISESINK_METHODS(PURE)
  881. };
  883. /* Callback function type for MAPIAllocAdviseSink */
  885. typedef long (STDAPICALLTYPE NOTIFCALLBACK) (
  886.     LPVOID          lpvContext,
  887.     ULONG           cNotification,
  888.     LPNOTIFICATION  lpNotifications);
  889. typedef NOTIFCALLBACK FAR * LPNOTIFCALLBACK;
  891. /*
  892.  *  Message name for the 16-bit MAPI notififcation engine.
  893.  *  This can be used in 16-bit applications to force processing
  894.  *  of notification callbacks.
  895.  */
  897. #define szMAPINotificationMsg "MAPI Notify window message"
  900. /* IMAPIProgress Interface ------------------------------------------------- */
  902. /* Flag values for the progress indicator */
  904. #define MAPI_TOP_LEVEL      ((ULONG) 0x00000001)
  906. #define MAPI_IMAPIPROGRESS_METHODS(IPURE)                               
  907.     MAPIMETHOD(Progress)                                                
  908.         (THIS_  ULONG                       ulValue,                    
  909.                 ULONG                       ulCount,                    
  910.                 ULONG                       ulTotal) IPURE;             
  911.     MAPIMETHOD(GetFlags)                                                
  912.         (THIS_  ULONG FAR *                 lpulFlags) IPURE;           
  913.     MAPIMETHOD(GetMax)                                                  
  914.         (THIS_  ULONG FAR *                 lpulMax) IPURE;             
  915.     MAPIMETHOD(GetMin)                                                  
  916.         (THIS_  ULONG FAR *                 lpulMin) IPURE;             
  917.     MAPIMETHOD(SetLimits)                                               
  918.         (THIS_  LPULONG                     lpulMin,                    
  919.                 LPULONG                     lpulMax,                    
  920.                 LPULONG                     lpulFlags) IPURE;           
  922. #undef      INTERFACE
  923. #define     INTERFACE   IMAPIProgress
  924. DECLARE_MAPI_INTERFACE_(IMAPIProgress, IUnknown)
  925. {
  926.     BEGIN_INTERFACE
  927.     MAPI_IUNKNOWN_METHODS(PURE)
  928.     MAPI_IMAPIPROGRESS_METHODS(PURE)
  929. };
  932. /* IMAPIProp Interface ----------------------------------------------------- */
  934. /* GetLastError */
  935. /****** MAPI_UNICODE            ((ULONG) 0x80000000) above */
  937. /*
  938.  *  Version:
  939.  */
  940. #define MAPI_ERROR_VERSION      0x00000000L
  942. /* GetPropList */
  943. /****** MAPI_UNICODE            ((ULONG) 0x80000000) above */
  945. /* GetProps */
  946. /****** MAPI_UNICODE            ((ULONG) 0x80000000) above */
  948. /* SaveChanges */
  950. #define KEEP_OPEN_READONLY      ((ULONG) 0x00000001)
  951. #define KEEP_OPEN_READWRITE     ((ULONG) 0x00000002)
  952. #define FORCE_SAVE              ((ULONG) 0x00000004)
  953. /* define MAPI_DEFERRED_ERRORS  ((ULONG) 0x00000008) below */
  955. /* OpenProperty  - ulFlags */
  956. /****** MAPI_MODIFY             ((ULONG) 0x00000001) above */
  957. #define MAPI_CREATE             ((ULONG) 0x00000002)
  958. #define STREAM_APPEND           ((ULONG) 0x00000004)
  959. /****** MAPI_DEFERRED_ERRORS    ((ULONG) 0x00000008) below */
  961. /* OpenProperty  - ulInterfaceOptions, IID_IMAPITable */
  962. /****** MAPI_UNICODE            ((ULONG) 0x80000000) above */
  964. /* CopyTo, CopyProps */
  966. #define MAPI_MOVE               ((ULONG) 0x00000001)
  967. #define MAPI_NOREPLACE          ((ULONG) 0x00000002)
  968. #define MAPI_DECLINE_OK         ((ULONG) 0x00000004)
  970. #ifndef MAPI_DIALOG             /* also defined in mapi.h */
  971. #define MAPI_DIALOG             ((ULONG) 0x00000008)
  972. #endif
  974. #ifndef MAPI_USE_DEFAULT        /* also defined in mapi.h */
  975. #define MAPI_USE_DEFAULT        0x00000040  /* Use default profile in logon */
  976. #endif
  978. /* Flags used in GetIDsFromNames  */
  979. /****** MAPI_CREATE             ((ULONG) 0x00000002) above */
  981. /* Flags used in GetNamesFromIDs  (bit fields) */
  982. #define MAPI_NO_STRINGS         ((ULONG) 0x00000001)
  983. #define MAPI_NO_IDS             ((ULONG) 0x00000002)
  985. /*  Union discriminator  */
  986. #define MNID_ID                 0
  987. #define MNID_STRING             1
  988. typedef struct _MAPINAMEID
  989. {
  990.     LPGUID lpguid;
  991.     ULONG ulKind;
  992.     union {
  993.         LONG lID;
  994.         LPWSTR lpwstrName;
  995.     } Kind;
  997. } MAPINAMEID, FAR * LPMAPINAMEID;
  999. #define MAPI_IMAPIPROP_METHODS(IPURE)                                   
  1000.     MAPIMETHOD(GetLastError)                                            
  1001.         (THIS_  HRESULT                     hResult,                    
  1002.                 ULONG                       ulFlags,                    
  1003.                 LPMAPIERROR FAR *           lppMAPIError) IPURE;        
  1004.     MAPIMETHOD(SaveChanges)                                             
  1005.         (THIS_ ULONG                        ulFlags) IPURE;             
  1006.     MAPIMETHOD(GetProps)                                                
  1007.         (THIS_  LPSPropTagArray             lpPropTagArray,             
  1008.                 ULONG                       ulFlags,                    
  1009.                 ULONG FAR *                 lpcValues,                  
  1010.                 LPSPropValue FAR *          lppPropArray) IPURE;        
  1011.     MAPIMETHOD(GetPropList)                                             
  1012.         (THIS_  ULONG                       ulFlags,                    
  1013.                 LPSPropTagArray FAR *       lppPropTagArray) IPURE;     
  1014.     MAPIMETHOD(OpenProperty)                                            
  1015.         (THIS_  ULONG                       ulPropTag,                  
  1016.                 LPCIID                      lpiid,                      
  1017.                 ULONG                       ulInterfaceOptions,         
  1018.                 ULONG                       ulFlags,                    
  1019.                 LPUNKNOWN FAR *             lppUnk) IPURE;              
  1020.     MAPIMETHOD(SetProps)                                                
  1021.         (THIS_  ULONG                       cValues,                    
  1022.                 LPSPropValue                lpPropArray,                
  1023.                 LPSPropProblemArray FAR *   lppProblems) IPURE;         
  1024.     MAPIMETHOD(DeleteProps)                                             
  1025.         (THIS_  LPSPropTagArray             lpPropTagArray,             
  1026.                 LPSPropProblemArray FAR *   lppProblems) IPURE;         
  1027.     MAPIMETHOD(CopyTo)                                                  
  1028.         (THIS_  ULONG                       ciidExclude,                
  1029.                 LPCIID                      rgiidExclude,               
  1030.                 LPSPropTagArray             lpExcludeProps,             
  1031.                 ULONG                       ulUIParam,                  
  1032.                 LPMAPIPROGRESS              lpProgress,                 
  1033.                 LPCIID                      lpInterface,                
  1034.                 LPVOID                      lpDestObj,                  
  1035.                 ULONG                       ulFlags,                    
  1036.                 LPSPropProblemArray FAR *   lppProblems) IPURE;         
  1037.     MAPIMETHOD(CopyProps)                                               
  1038.         (THIS_  LPSPropTagArray             lpIncludeProps,             
  1039.                 ULONG                       ulUIParam,                  
  1040.                 LPMAPIPROGRESS              lpProgress,                 
  1041.                 LPCIID                      lpInterface,                
  1042.                 LPVOID                      lpDestObj,                  
  1043.                 ULONG                       ulFlags,                    
  1044.                 LPSPropProblemArray FAR *   lppProblems) IPURE;         
  1045.     MAPIMETHOD(GetNamesFromIDs)                                         
  1046.         (THIS_  LPSPropTagArray FAR *       lppPropTags,                
  1047.                 LPGUID                      lpPropSetGuid,              
  1048.                 ULONG                       ulFlags,                    
  1049.                 ULONG FAR *                 lpcPropNames,               
  1050.                 LPMAPINAMEID FAR * FAR *    lpppPropNames) IPURE;       
  1051.     MAPIMETHOD(GetIDsFromNames)                                         
  1052.         (THIS_  ULONG                       cPropNames,                 
  1053.                 LPMAPINAMEID FAR *          lppPropNames,               
  1054.                 ULONG                       ulFlags,                    
  1055.                 LPSPropTagArray FAR *       lppPropTags) IPURE;         
  1057. #undef       INTERFACE
  1058. #define      INTERFACE  IMAPIProp
  1059. DECLARE_MAPI_INTERFACE_(IMAPIProp, IUnknown)
  1060. {
  1061.     BEGIN_INTERFACE
  1062.     MAPI_IUNKNOWN_METHODS(PURE)
  1063.     MAPI_IMAPIPROP_METHODS(PURE)
  1064. };
  1066. /* IMAPITable Interface ---------------------------------------------------- */
  1068. /* Table status */
  1070. #define TBLSTAT_COMPLETE            ((ULONG) 0)
  1071. #define TBLSTAT_QCHANGED            ((ULONG) 7)
  1072. #define TBLSTAT_SORTING             ((ULONG) 9)
  1073. #define TBLSTAT_SORT_ERROR          ((ULONG) 10)
  1074. #define TBLSTAT_SETTING_COLS        ((ULONG) 11)
  1075. #define TBLSTAT_SETCOL_ERROR        ((ULONG) 13)
  1076. #define TBLSTAT_RESTRICTING         ((ULONG) 14)
  1077. #define TBLSTAT_RESTRICT_ERROR      ((ULONG) 15)
  1080. /* Table Type */
  1082. #define TBLTYPE_SNAPSHOT            ((ULONG) 0)
  1083. #define TBLTYPE_KEYSET              ((ULONG) 1)
  1084. #define TBLTYPE_DYNAMIC             ((ULONG) 2)
  1087. /* Sort order */
  1089. /* bit 0: set if descending, clear if ascending */
  1091. #define TABLE_SORT_ASCEND       ((ULONG) 0x00000000)
  1092. #define TABLE_SORT_DESCEND      ((ULONG) 0x00000001)
  1093. #define TABLE_SORT_COMBINE      ((ULONG) 0x00000002)
  1096. /* Data structures */
  1098. typedef struct _SSortOrder
  1099. {
  1100.     ULONG   ulPropTag;          /* Column to sort on */
  1101.     ULONG   ulOrder;            /* Ascending, descending, combine to left */
  1102. } SSortOrder, FAR * LPSSortOrder;
  1104. typedef struct _SSortOrderSet
  1105. {
  1106.     ULONG           cSorts;     /* Number of sort columns in aSort below*/
  1107.     ULONG           cCategories;    /* 0 for non-categorized, up to cSorts */
  1108.     ULONG           cExpanded;      /* 0 if no categories start expanded, */
  1109.                                     /*      up to cExpanded */
  1110.     SSortOrder      aSort[MAPI_DIM];    /* The sort orders */
  1111. } SSortOrderSet, FAR * LPSSortOrderSet;
  1113. #define CbNewSSortOrderSet(_csort) 
  1114.     (offsetof(SSortOrderSet,aSort) + (_csort)*sizeof(SSortOrder))
  1115. #define CbSSortOrderSet(_lpset) 
  1116.     (offsetof(SSortOrderSet,aSort) + 
  1117.     (UINT)((_lpset)->cSorts*sizeof(SSortOrder)))
  1118. #define SizedSSortOrderSet(_csort, _name) 
  1119. struct _SSortOrderSet_ ## _name 
  1120. { 
  1121.     ULONG           cSorts;         
  1122.     ULONG           cCategories;    
  1123.     ULONG           cExpanded;      
  1124.     SSortOrder      aSort[_csort];  
  1125. } _name
  1127. typedef ULONG       BOOKMARK;
  1129. #define BOOKMARK_BEGINNING  ((BOOKMARK) 0)      /* Before first row */
  1130. #define BOOKMARK_CURRENT    ((BOOKMARK) 1)      /* Before current row */
  1131. #define BOOKMARK_END        ((BOOKMARK) 2)      /* After last row */
  1133. /* Fuzzy Level */
  1135. #define FL_FULLSTRING       ((ULONG) 0x00000000)
  1136. #define FL_SUBSTRING        ((ULONG) 0x00000001)
  1137. #define FL_PREFIX           ((ULONG) 0x00000002)
  1139. #define FL_IGNORECASE       ((ULONG) 0x00010000)
  1140. #define FL_IGNORENONSPACE   ((ULONG) 0x00020000)
  1141. #define FL_LOOSE            ((ULONG) 0x00040000)
  1143. /* Restrictions */
  1145. typedef struct _SRestriction    FAR * LPSRestriction;
  1147. /* Restriction types */
  1149. #define RES_AND             ((ULONG) 0x00000000)
  1150. #define RES_OR              ((ULONG) 0x00000001)
  1151. #define RES_NOT             ((ULONG) 0x00000002)
  1152. #define RES_CONTENT         ((ULONG) 0x00000003)
  1153. #define RES_PROPERTY        ((ULONG) 0x00000004)
  1154. #define RES_COMPAREPROPS    ((ULONG) 0x00000005)
  1155. #define RES_BITMASK         ((ULONG) 0x00000006)
  1156. #define RES_SIZE            ((ULONG) 0x00000007)
  1157. #define RES_EXIST           ((ULONG) 0x00000008)
  1158. #define RES_SUBRESTRICTION  ((ULONG) 0x00000009)
  1159. #define RES_COMMENT         ((ULONG) 0x0000000A)
  1161. /* Relational operators. These apply to all property comparison restrictions. */
  1163. #define RELOP_LT        ((ULONG) 0)     /* <  */
  1164. #define RELOP_LE        ((ULONG) 1)     /* <= */
  1165. #define RELOP_GT        ((ULONG) 2)     /* >  */
  1166. #define RELOP_GE        ((ULONG) 3)     /* >= */
  1167. #define RELOP_EQ        ((ULONG) 4)     /* == */
  1168. #define RELOP_NE        ((ULONG) 5)     /* != */
  1169. #define RELOP_RE        ((ULONG) 6)     /* LIKE (Regular expression) */
  1171. /* Bitmask operators, for RES_BITMASK only. */
  1173. #define BMR_EQZ     ((ULONG) 0)     /* ==0 */
  1174. #define BMR_NEZ     ((ULONG) 1)     /* !=0 */
  1176. /* Subobject identifiers for RES_SUBRESTRICTION only. See MAPITAGS.H. */
  1178. /* #define PR_MESSAGE_RECIPIENTS  PROP_TAG(PT_OBJECT,0x0E12) */
  1179. /* #define PR_MESSAGE_ATTACHMENTS PROP_TAG(PT_OBJECT,0x0E13) */
  1181. typedef struct _SAndRestriction
  1182. {
  1183.     ULONG           cRes;
  1184.     LPSRestriction  lpRes;
  1185. } SAndRestriction;
  1187. typedef struct _SOrRestriction
  1188. {
  1189.     ULONG           cRes;
  1190.     LPSRestriction  lpRes;
  1191. } SOrRestriction;
  1193. typedef struct _SNotRestriction
  1194. {
  1195.     ULONG           ulReserved;
  1196.     LPSRestriction  lpRes;
  1197. } SNotRestriction;
  1199. typedef struct _SContentRestriction
  1200. {
  1201.     ULONG           ulFuzzyLevel;
  1202.     ULONG           ulPropTag;
  1203.     LPSPropValue    lpProp;
  1204. } SContentRestriction;
  1206. typedef struct _SBitMaskRestriction
  1207. {
  1208.     ULONG           relBMR;
  1209.     ULONG           ulPropTag;
  1210.     ULONG           ulMask;
  1211. } SBitMaskRestriction;
  1213. typedef struct _SPropertyRestriction
  1214. {
  1215.     ULONG           relop;
  1216.     ULONG           ulPropTag;
  1217.     LPSPropValue    lpProp;
  1218. } SPropertyRestriction;
  1220. typedef struct _SComparePropsRestriction
  1221. {
  1222.     ULONG           relop;
  1223.     ULONG           ulPropTag1;
  1224.     ULONG           ulPropTag2;
  1225. } SComparePropsRestriction;
  1227. typedef struct _SSizeRestriction
  1228. {
  1229.     ULONG           relop;
  1230.     ULONG           ulPropTag;
  1231.     ULONG           cb;
  1232. } SSizeRestriction;
  1234. typedef struct _SExistRestriction
  1235. {
  1236.     ULONG           ulReserved1;
  1237.     ULONG           ulPropTag;
  1238.     ULONG           ulReserved2;
  1239. } SExistRestriction;
  1241. typedef struct _SSubRestriction
  1242. {
  1243.     ULONG           ulSubObject;
  1244.     LPSRestriction  lpRes;
  1245. } SSubRestriction;
  1247. typedef struct _SCommentRestriction
  1248. {
  1249.     ULONG           cValues; /* # of properties in lpProp */
  1250.     LPSRestriction  lpRes;
  1251.     LPSPropValue    lpProp;
  1252. } SCommentRestriction;
  1254. typedef struct _SRestriction
  1255. {
  1256.     ULONG   rt;         /* Restriction type */
  1257.     union
  1258.     {
  1259.         SComparePropsRestriction    resCompareProps;    /* first */
  1260.         SAndRestriction             resAnd;
  1261.         SOrRestriction              resOr;
  1262.         SNotRestriction             resNot;
  1263.         SContentRestriction         resContent;
  1264.         SPropertyRestriction        resProperty;
  1265.         SBitMaskRestriction         resBitMask;
  1266.         SSizeRestriction            resSize;
  1267.         SExistRestriction           resExist;
  1268.         SSubRestriction             resSub;
  1269.         SCommentRestriction         resComment;
  1270.     } res;
  1271. } SRestriction;
  1273. /* SComparePropsRestriction is first in the union so that */
  1274. /* static initializations of 3-value restriction work.    */
  1276. /* Flags of the methods of IMAPITable */
  1278. /* QueryColumn */
  1280. #define TBL_ALL_COLUMNS     ((ULONG) 0x00000001)
  1282. /* QueryRows */
  1283. /* Possible values for PR_ROW_TYPE (for categorization) */
  1285. #define TBL_LEAF_ROW            ((ULONG) 1)
  1286. #define TBL_EMPTY_CATEGORY      ((ULONG) 2)
  1287. #define TBL_EXPANDED_CATEGORY   ((ULONG) 3)
  1288. #define TBL_COLLAPSED_CATEGORY  ((ULONG) 4)
  1290. /* Table wait flag */
  1292. #define TBL_NOWAIT          ((ULONG) 0x00000001)
  1293. /* alternative name for TBL_NOWAIT */
  1294. #define TBL_ASYNC           ((ULONG) 0x00000001)
  1295. #define TBL_BATCH           ((ULONG) 0x00000002)
  1297. /* FindRow */
  1299. #define DIR_BACKWARD        ((ULONG) 0x00000001)
  1301. /* Table cursor states */
  1303. #define TBL_NOADVANCE       ((ULONG) 0x00000001)
  1305. #define MAPI_IMAPITABLE_METHODS(IPURE)                                  
  1306.     MAPIMETHOD(GetLastError)                                            
  1307.         (THIS_  HRESULT                     hResult,                    
  1308.                 ULONG                       ulFlags,                    
  1309.                 LPMAPIERROR FAR *           lppMAPIError) IPURE;        
  1310.     MAPIMETHOD(Advise)                                                  
  1311.         (THIS_  ULONG                       ulEventMask,                
  1312.                 LPMAPIADVISESINK            lpAdviseSink,               
  1313.                 ULONG FAR *                 lpulConnection) IPURE;      
  1314.     MAPIMETHOD(Unadvise)                                                
  1315.         (THIS_  ULONG                       ulConnection) IPURE;        
  1316.     MAPIMETHOD(GetStatus)                                               
  1317.         (THIS_  ULONG FAR *                 lpulTableStatus,            
  1318.                 ULONG FAR *                 lpulTableType) IPURE;       
  1319.     MAPIMETHOD(SetColumns)                                              
  1320.         (THIS_  LPSPropTagArray             lpPropTagArray,             
  1321.                 ULONG                       ulFlags) IPURE;             
  1322.     MAPIMETHOD(QueryColumns)                                            
  1323.         (THIS_  ULONG                       ulFlags,                    
  1324.                 LPSPropTagArray FAR *       lpPropTagArray) IPURE;      
  1325.     MAPIMETHOD(GetRowCount)                                             
  1326.         (THIS_  ULONG                       ulFlags,                    
  1327.                 ULONG FAR *                 lpulCount) IPURE;           
  1328.     MAPIMETHOD(SeekRow)                                                 
  1329.         (THIS_  BOOKMARK                    bkOrigin,                   
  1330.                 LONG                        lRowCount,                  
  1331.                 LONG FAR *                  lplRowsSought) IPURE;       
  1332.     MAPIMETHOD(SeekRowApprox)                                           
  1333.         (THIS_  ULONG                       ulNumerator,                
  1334.                 ULONG                       ulDenominator) IPURE;       
  1335.     MAPIMETHOD(QueryPosition)                                           
  1336.         (THIS_  ULONG FAR *                 lpulRow,                    
  1337.                 ULONG FAR *                 lpulNumerator,              
  1338.                 ULONG FAR *                 lpulDenominator) IPURE;     
  1339.     MAPIMETHOD(FindRow)                                                 
  1340.         (THIS_  LPSRestriction              lpRestriction,              
  1341.                 BOOKMARK                    bkOrigin,                   
  1342.                 ULONG                       ulFlags) IPURE;             
  1343.     MAPIMETHOD(Restrict)                                                
  1344.         (THIS_  LPSRestriction              lpRestriction,              
  1345.                 ULONG                       ulFlags) IPURE;             
  1346.     MAPIMETHOD(CreateBookmark)                                          
  1347.         (THIS_  BOOKMARK FAR *              lpbkPosition) IPURE;        
  1348.     MAPIMETHOD(FreeBookmark)                                            
  1349.         (THIS_  BOOKMARK                    bkPosition) IPURE;          
  1350.     MAPIMETHOD(SortTable)                                               
  1351.         (THIS_  LPSSortOrderSet             lpSortCriteria,             
  1352.                 ULONG                       ulFlags) IPURE;             
  1353.     MAPIMETHOD(QuerySortOrder)                                          
  1354.         (THIS_  LPSSortOrderSet FAR *       lppSortCriteria) IPURE;     
  1355.     MAPIMETHOD(QueryRows)                                               
  1356.         (THIS_  LONG                        lRowCount,                  
  1357.                 ULONG                       ulFlags,                    
  1358.                 LPSRowSet FAR *             lppRows) IPURE;             
  1359.     MAPIMETHOD(Abort) (THIS) IPURE;                                     
  1360.     MAPIMETHOD(ExpandRow)                                               
  1361.         (THIS_  ULONG                       cbInstanceKey,              
  1362.                 LPBYTE                      pbInstanceKey,              
  1363.                 ULONG                       ulRowCount,                 
  1364.                 ULONG                       ulFlags,                    
  1365.                 LPSRowSet FAR *             lppRows,                    
  1366.                 ULONG FAR *                 lpulMoreRows) IPURE;        
  1367.     MAPIMETHOD(CollapseRow)                                             
  1368.         (THIS_  ULONG                       cbInstanceKey,              
  1369.                 LPBYTE                      pbInstanceKey,              
  1370.                 ULONG                       ulFlags,                    
  1371.                 ULONG FAR *                 lpulRowCount) IPURE;        
  1372.     MAPIMETHOD(WaitForCompletion)                                       
  1373.         (THIS_  ULONG                       ulFlags,                    
  1374.                 ULONG                       ulTimeout,                  
  1375.                 ULONG FAR *                 lpulTableStatus) IPURE;     
  1376.     MAPIMETHOD(GetCollapseState)                                        
  1377.         (THIS_  ULONG                       ulFlags,                    
  1378.                 ULONG                       cbInstanceKey,              
  1379.                 LPBYTE                      lpbInstanceKey,             
  1380.                 ULONG FAR *                 lpcbCollapseState,          
  1381.                 LPBYTE FAR *                lppbCollapseState) IPURE;   
  1382.     MAPIMETHOD(SetCollapseState)                                        
  1383.         (THIS_  ULONG                       ulFlags,                    
  1384.                 ULONG                       cbCollapseState,            
  1385.                 LPBYTE                      pbCollapseState,            
  1386.                 BOOKMARK FAR *              lpbkLocation) IPURE;        
  1388. #undef       INTERFACE
  1389. #define      INTERFACE  IMAPITable
  1390. DECLARE_MAPI_INTERFACE_(IMAPITable, IUnknown)
  1391. {
  1392.     BEGIN_INTERFACE
  1393.     MAPI_IUNKNOWN_METHODS(PURE)
  1394.     MAPI_IMAPITABLE_METHODS(PURE)
  1395. };
  1397. /* IProfSect Interface ----------------------------------------------------- */
  1399. /* Standard section for public profile properties */
  1401. #define PS_PROFILE_PROPERTIES_INIT 
  1402. {   0x98, 0x15, 0xAC, 0x08, 0xAA, 0xB0, 0x10, 0x1A, 
  1403.     0x8C, 0x93, 0x08, 0x00, 0x2B, 0x2A, 0x56, 0xC2  }
  1406. #define MAPI_IPROFSECT_METHODS(IPURE)
  1408. #undef       INTERFACE
  1409. #define      INTERFACE  IProfSect
  1410. DECLARE_MAPI_INTERFACE_(IProfSect, IMAPIProp)
  1411. {
  1412.     BEGIN_INTERFACE
  1413.     MAPI_IUNKNOWN_METHODS(PURE)
  1414.     MAPI_IMAPIPROP_METHODS(PURE)
  1415.     MAPI_IPROFSECT_METHODS(PURE)
  1416. };
  1418. /* IMAPIStatus Interface --------------------------------------------------- */
  1420. /* Values for PR_RESOURCE_TYPE, _METHODS, _FLAGS */
  1422. #define MAPI_STORE_PROVIDER     ((ULONG) 33)    /* Message Store */
  1423. #define MAPI_AB                 ((ULONG) 34)    /* Address Book */
  1424. #define MAPI_AB_PROVIDER        ((ULONG) 35)    /* Address Book Provider */
  1425. #define MAPI_TRANSPORT_PROVIDER ((ULONG) 36)    /* Transport Provider */
  1426. #define MAPI_SPOOLER            ((ULONG) 37)    /* Message Spooler */
  1427. #define MAPI_PROFILE_PROVIDER   ((ULONG) 38)    /* Profile Provider */
  1428. #define MAPI_SUBSYSTEM          ((ULONG) 39)    /* Overall Subsystem Status */
  1429. #define MAPI_HOOK_PROVIDER      ((ULONG) 40)    /* Spooler Hook */
  1431. #define STATUS_VALIDATE_STATE   ((ULONG) 0x00000001)
  1432. #define STATUS_SETTINGS_DIALOG  ((ULONG) 0x00000002)
  1433. #define STATUS_CHANGE_PASSWORD  ((ULONG) 0x00000004)
  1434. #define STATUS_FLUSH_QUEUES     ((ULONG) 0x00000008)
  1436. #define STATUS_DEFAULT_OUTBOUND ((ULONG) 0x00000001)
  1437. #define STATUS_DEFAULT_STORE    ((ULONG) 0x00000002)
  1438. #define STATUS_PRIMARY_IDENTITY ((ULONG) 0x00000004)
  1439. #define STATUS_SIMPLE_STORE     ((ULONG) 0x00000008)
  1440. #define STATUS_XP_PREFER_LAST   ((ULONG) 0x00000010)
  1441. #define STATUS_NO_PRIMARY_IDENTITY ((ULONG) 0x00000020)
  1442. #define STATUS_NO_DEFAULT_STORE ((ULONG) 0x00000040)
  1443. #define STATUS_TEMP_SECTION     ((ULONG) 0x00000080)
  1444. #define STATUS_OWN_STORE        ((ULONG) 0x00000100)
  1445. /****** HOOK_INBOUND            ((ULONG) 0x00000200) Defined in MAPIHOOK.H */
  1446. /****** HOOK_OUTBOUND           ((ULONG) 0x00000400) Defined in MAPIHOOK.H */
  1447. #define STATUS_NEED_IPM_TREE    ((ULONG) 0x00000800)
  1448. #define STATUS_PRIMARY_STORE    ((ULONG) 0x00001000)
  1449. #define STATUS_SECONDARY_STORE  ((ULONG) 0x00002000)
  1452. /*
  1453.  * PR_STATUS_CODE bit. Low 16 bits for common values; High 16 bits
  1454.  * for provider type-specific values. (DCR 304)
  1455.  */
  1457. #define STATUS_AVAILABLE        ((ULONG) 0x00000001)
  1458. #define STATUS_OFFLINE          ((ULONG) 0x00000002)
  1459. #define STATUS_FAILURE          ((ULONG) 0x00000004)
  1461. /* Transport values of PR_STATUS_CODE */
  1463. #define STATUS_INBOUND_ENABLED  ((ULONG) 0x00010000)
  1464. #define STATUS_INBOUND_ACTIVE   ((ULONG) 0x00020000)
  1465. #define STATUS_INBOUND_FLUSH    ((ULONG) 0x00040000)
  1466. #define STATUS_OUTBOUND_ENABLED ((ULONG) 0x00100000)
  1467. #define STATUS_OUTBOUND_ACTIVE  ((ULONG) 0x00200000)
  1468. #define STATUS_OUTBOUND_FLUSH   ((ULONG) 0x00400000)
  1469. #define STATUS_REMOTE_ACCESS    ((ULONG) 0x00800000)
  1471. /* ValidateState flags */
  1473. #define SUPPRESS_UI                 ((ULONG) 0x00000001)
  1474. #define REFRESH_XP_HEADER_CACHE     ((ULONG) 0x00010000)
  1475. #define PROCESS_XP_HEADER_CACHE     ((ULONG) 0x00020000)
  1476. #define FORCE_XP_CONNECT            ((ULONG) 0x00040000)
  1477. #define FORCE_XP_DISCONNECT         ((ULONG) 0x00080000)
  1478. #define CONFIG_CHANGED              ((ULONG) 0x00100000)
  1479. #define ABORT_XP_HEADER_OPERATION   ((ULONG) 0x00200000)
  1480. #define SHOW_XP_SESSION_UI          ((ULONG) 0x00400000)
  1482. /* SettingsDialog flags */
  1484. #define UI_READONLY     ((ULONG) 0x00000001)
  1486. /* FlushQueues flags */
  1488. #define FLUSH_UPLOAD        ((ULONG) 0x00000002)
  1489. #define FLUSH_DOWNLOAD      ((ULONG) 0x00000004)
  1490. #define FLUSH_FORCE         ((ULONG) 0x00000008)
  1491. #define FLUSH_NO_UI         ((ULONG) 0x00000010)
  1492. #define FLUSH_ASYNC_OK      ((ULONG) 0x00000020)
  1494. #define MAPI_IMAPISTATUS_METHODS(IPURE)                                 
  1495.     MAPIMETHOD(ValidateState)                                           
  1496.         (THIS_  ULONG                       ulUIParam,                  
  1497.                 ULONG                       ulFlags) IPURE;             
  1498.     MAPIMETHOD(SettingsDialog)                                          
  1499.         (THIS_  ULONG                       ulUIParam,                  
  1500.                 ULONG                       ulFlags) IPURE;             
  1501.     MAPIMETHOD(ChangePassword)                                          
  1502.         (THIS_  LPTSTR                      lpOldPass,                  
  1503.                 LPTSTR                      lpNewPass,                  
  1504.                 ULONG                       ulFlags) IPURE;             
  1505.     MAPIMETHOD(FlushQueues)                                             
  1506.         (THIS_  ULONG                       ulUIParam,                  
  1507.                 ULONG                       cbTargetTransport,          
  1508.                 LPENTRYID                   lpTargetTransport,          
  1509.                 ULONG                       ulFlags) IPURE;             
  1511. #undef       INTERFACE
  1512. #define      INTERFACE  IMAPIStatus
  1513. DECLARE_MAPI_INTERFACE_(IMAPIStatus, IMAPIProp)
  1514. {
  1515.     BEGIN_INTERFACE
  1516.     MAPI_IUNKNOWN_METHODS(PURE)
  1517.     MAPI_IMAPIPROP_METHODS(PURE)
  1518.     MAPI_IMAPISTATUS_METHODS(PURE)
  1519. };
  1521. /* IMAPIContainer Interface ------------------------------------------------ */
  1523. /* Flags for OpenEntry() */
  1525. /****** MAPI_MODIFY             ((ULONG) 0x00000001) above */
  1526. /****** MAPI_DEFERRED_ERRORS    ((ULONG) 0x00000008) below */
  1527. #define MAPI_BEST_ACCESS        ((ULONG) 0x00000010)
  1529. /* GetContentsTable() */
  1530. /****** MAPI_UNICODE            ((ULONG) 0x80000000) above */
  1531. /****** MAPI_DEFERRED_ERRORS    ((ULONG) 0x00000008) below */
  1532. /****** MAPI_ASSOCIATED         ((ULONG) 0x00000040) below */
  1533. #define WAB_LOCAL_CONTAINERS    0x00100000
  1534. #define WAB_PROFILE_CONTENTS    0x00200000
  1536. /* GetHierarchyTable() */
  1537. /****** MAPI_UNICODE            ((ULONG) 0x80000000) above */
  1538. #define CONVENIENT_DEPTH        ((ULONG) 0x00000001)
  1539. /****** MAPI_DEFERRED_ERRORS    ((ULONG) 0x00000008) below */
  1541. /* GetSearchCriteria */
  1542. /****** MAPI_UNICODE            ((ULONG) 0x80000000) above */
  1543. #define SEARCH_RUNNING          ((ULONG) 0x00000001)
  1544. #define SEARCH_REBUILD          ((ULONG) 0x00000002)
  1545. #define SEARCH_RECURSIVE        ((ULONG) 0x00000004)
  1546. #define SEARCH_FOREGROUND       ((ULONG) 0x00000008)
  1548. /* SetSearchCriteria */
  1549. #define STOP_SEARCH             ((ULONG) 0x00000001)
  1550. #define RESTART_SEARCH          ((ULONG) 0x00000002)
  1551. #define RECURSIVE_SEARCH        ((ULONG) 0x00000004)
  1552. #define SHALLOW_SEARCH          ((ULONG) 0x00000008)
  1553. #define FOREGROUND_SEARCH       ((ULONG) 0x00000010)
  1554. #define BACKGROUND_SEARCH       ((ULONG) 0x00000020)
  1556. #define MAPI_IMAPICONTAINER_METHODS(IPURE)                              
  1557.     MAPIMETHOD(GetContentsTable)                                        
  1558.         (THIS_  ULONG                       ulFlags,                    
  1559.                 LPMAPITABLE FAR *           lppTable) IPURE;            
  1560.     MAPIMETHOD(GetHierarchyTable)                                       
  1561.         (THIS_  ULONG                       ulFlags,                    
  1562.                 LPMAPITABLE FAR *           lppTable) IPURE;            
  1563.     MAPIMETHOD(OpenEntry)                                               
  1564.         (THIS_  ULONG                       cbEntryID,                  
  1565.                 LPENTRYID                   lpEntryID,                  
  1566.                 LPCIID                      lpInterface,                
  1567.                 ULONG                       ulFlags,                    
  1568.                 ULONG FAR *                 lpulObjType,                
  1569.                 LPUNKNOWN FAR *             lppUnk) IPURE;              
  1570.     MAPIMETHOD(SetSearchCriteria)                                       
  1571.         (THIS_  LPSRestriction              lpRestriction,              
  1572.                 LPENTRYLIST                 lpContainerList,            
  1573.                 ULONG                       ulSearchFlags) IPURE;       
  1574.     MAPIMETHOD(GetSearchCriteria)                                       
  1575.         (THIS_  ULONG                       ulFlags,                    
  1576.                 LPSRestriction FAR *        lppRestriction,             
  1577.                 LPENTRYLIST FAR *           lppContainerList,           
  1578.                 ULONG FAR *                 lpulSearchState)IPURE;      
  1580. #undef       INTERFACE
  1581. #define      INTERFACE  IMAPIContainer
  1582. DECLARE_MAPI_INTERFACE_(IMAPIContainer, IMAPIProp)
  1583. {
  1584.     BEGIN_INTERFACE
  1585.     MAPI_IUNKNOWN_METHODS(PURE)
  1586.     MAPI_IMAPIPROP_METHODS(PURE)
  1587.     MAPI_IMAPICONTAINER_METHODS(PURE)
  1588. };
  1590. /* IABContainer Interface -------------------------------------------------- */
  1592. /*
  1593.  *  IABContainer PR_CONTAINER_FLAGS values
  1594.  *  If AB_UNMODIFIABLE and AB_MODIFIABLE are both set, it means the container
  1595.  *  doesn't know if it's modifiable or not, and the client should
  1596.  *  try to modify the contents but we won't expect it to work.
  1597.  *  If the AB_RECIPIENTS flag is set and neither AB_MODIFIABLE or AB_UNMODIFIABLE
  1598.  *  bits are set, it is an error.
  1599.  */
  1601. typedef struct _flaglist
  1602. {
  1603.     ULONG cFlags;
  1604.     ULONG ulFlag[MAPI_DIM];
  1605. } FlagList, FAR * LPFlagList;
  1608. /*
  1609.  *  Container flags
  1610.  */
  1611. #define AB_RECIPIENTS           ((ULONG) 0x00000001)
  1612. #define AB_SUBCONTAINERS        ((ULONG) 0x00000002)
  1613. #define AB_MODIFIABLE           ((ULONG) 0x00000004)
  1614. #define AB_UNMODIFIABLE         ((ULONG) 0x00000008)
  1615. #define AB_FIND_ON_OPEN         ((ULONG) 0x00000010)
  1616. #define AB_NOT_DEFAULT          ((ULONG) 0x00000020)
  1618. /* CreateEntry() */
  1620. #define CREATE_CHECK_DUP_STRICT ((ULONG) 0x00000001)
  1621. #define CREATE_CHECK_DUP_LOOSE  ((ULONG) 0x00000002)
  1622. #define CREATE_REPLACE          ((ULONG) 0x00000004)
  1623. #define CREATE_MERGE            ((ULONG) 0x00000008)
  1625. /* ResolveNames() - ulFlags */
  1626. /****** MAPI_UNICODE            ((ULONG) 0x80000000) above */
  1627. #define WAB_IGNORE_PROFILES     0x00800000
  1629. /* ResolveNames() - rgulFlags */
  1630. #define MAPI_UNRESOLVED         ((ULONG) 0x00000000)
  1631. #define MAPI_AMBIGUOUS          ((ULONG) 0x00000001)
  1632. #define MAPI_RESOLVED           ((ULONG) 0x00000002)
  1635. #define MAPI_IABCONTAINER_METHODS(IPURE)                                
  1636.     MAPIMETHOD(CreateEntry)                                             
  1637.         (THIS_  ULONG                       cbEntryID,                  
  1638.                 LPENTRYID                   lpEntryID,                  
  1639.                 ULONG                       ulCreateFlags,              
  1640.                 LPMAPIPROP FAR  *           lppMAPIPropEntry) IPURE;    
  1641.     MAPIMETHOD(CopyEntries)                                             
  1642.         (THIS_  LPENTRYLIST                 lpEntries,                  
  1643.                 ULONG                       ulUIParam,                  
  1644.                 LPMAPIPROGRESS              lpProgress,                 
  1645.                 ULONG                       ulFlags) IPURE;             
  1646.     MAPIMETHOD(DeleteEntries)                                           
  1647.         (THIS_  LPENTRYLIST                 lpEntries,                  
  1648.                 ULONG                       ulFlags) IPURE;             
  1649.     MAPIMETHOD(ResolveNames)                                            
  1650.         (THIS_  LPSPropTagArray             lpPropTagArray,             
  1651.                 ULONG                       ulFlags,                    
  1652.                 LPADRLIST                   lpAdrList,                  
  1653.                 LPFlagList                  lpFlagList) IPURE;          
  1655. #undef       INTERFACE
  1656. #define      INTERFACE  IABContainer
  1657. DECLARE_MAPI_INTERFACE_(IABContainer, IMAPIContainer)
  1658. {
  1659.     BEGIN_INTERFACE
  1660.     MAPI_IUNKNOWN_METHODS(PURE)
  1661.     MAPI_IMAPIPROP_METHODS(PURE)
  1662.     MAPI_IMAPICONTAINER_METHODS(PURE)
  1663.     MAPI_IABCONTAINER_METHODS(PURE)
  1664. };
  1666. /* IMailUser Interface ----------------------------------------------------- */
  1668. /*  Any call which can create a one-off entryID (i.e. MAPISupport::CreateOneOff
  1669.     or IAddrBook::CreateOneOff) can encode the value for PR_SEND_RICH_INFO by
  1670.     passing in the following flag in the ulFlags parameter.  Setting this flag
  1671.     indicates that PR_SEND_RICH_INFO will be FALSE.
  1672. */
  1673. #define MAPI_SEND_NO_RICH_INFO      ((ULONG) 0x00010000)
  1678. /* Values of PR_NDR_DIAG_CODE */
  1680. #define MAPI_DIAG(_code)    ((LONG) _code)
  1682. #define MAPI_DIAG_NO_DIAGNOSTIC                     MAPI_DIAG( -1 )
  1683. #define MAPI_DIAG_OR_NAME_UNRECOGNIZED              MAPI_DIAG( 0 )
  1684. #define MAPI_DIAG_OR_NAME_AMBIGUOUS                 MAPI_DIAG( 1 )
  1685. #define MAPI_DIAG_MTS_CONGESTED                     MAPI_DIAG( 2 )
  1686. #define MAPI_DIAG_LOOP_DETECTED                     MAPI_DIAG( 3 )
  1687. #define MAPI_DIAG_RECIPIENT_UNAVAILABLE             MAPI_DIAG( 4 )
  1688. #define MAPI_DIAG_MAXIMUM_TIME_EXPIRED              MAPI_DIAG( 5 )
  1689. #define MAPI_DIAG_EITS_UNSUPPORTED                  MAPI_DIAG( 6 )
  1690. #define MAPI_DIAG_CONTENT_TOO_LONG                  MAPI_DIAG( 7 )
  1691. #define MAPI_DIAG_IMPRACTICAL_TO_CONVERT            MAPI_DIAG( 8 )
  1692. #define MAPI_DIAG_PROHIBITED_TO_CONVERT             MAPI_DIAG( 9 )
  1693. #define MAPI_DIAG_CONVERSION_UNSUBSCRIBED           MAPI_DIAG( 10 )
  1694. #define MAPI_DIAG_PARAMETERS_INVALID                MAPI_DIAG( 11 )
  1695. #define MAPI_DIAG_CONTENT_SYNTAX_IN_ERROR           MAPI_DIAG( 12 )
  1696. #define MAPI_DIAG_LENGTH_CONSTRAINT_VIOLATD         MAPI_DIAG( 13 )
  1697. #define MAPI_DIAG_NUMBER_CONSTRAINT_VIOLATD         MAPI_DIAG( 14 )
  1698. #define MAPI_DIAG_CONTENT_TYPE_UNSUPPORTED          MAPI_DIAG( 15 )
  1699. #define MAPI_DIAG_TOO_MANY_RECIPIENTS               MAPI_DIAG( 16 )
  1700. #define MAPI_DIAG_NO_BILATERAL_AGREEMENT            MAPI_DIAG( 17 )
  1701. #define MAPI_DIAG_CRITICAL_FUNC_UNSUPPORTED         MAPI_DIAG( 18 )
  1702. #define MAPI_DIAG_CONVERSION_LOSS_PROHIB            MAPI_DIAG( 19 )
  1703. #define MAPI_DIAG_LINE_TOO_LONG                     MAPI_DIAG( 20 )
  1704. #define MAPI_DIAG_PAGE_TOO_LONG                     MAPI_DIAG( 21 )
  1705. #define MAPI_DIAG_PICTORIAL_SYMBOL_LOST             MAPI_DIAG( 22 )
  1706. #define MAPI_DIAG_PUNCTUATION_SYMBOL_LOST           MAPI_DIAG( 23 )
  1707. #define MAPI_DIAG_ALPHABETIC_CHARACTER_LOST         MAPI_DIAG( 24 )
  1708. #define MAPI_DIAG_MULTIPLE_INFO_LOSSES              MAPI_DIAG( 25 )
  1709. #define MAPI_DIAG_REASSIGNMENT_PROHIBITED           MAPI_DIAG( 26 )
  1710. #define MAPI_DIAG_REDIRECTION_LOOP_DETECTED         MAPI_DIAG( 27 )
  1711. #define MAPI_DIAG_EXPANSION_PROHIBITED              MAPI_DIAG( 28 )
  1712. #define MAPI_DIAG_SUBMISSION_PROHIBITED             MAPI_DIAG( 29 )
  1713. #define MAPI_DIAG_EXPANSION_FAILED                  MAPI_DIAG( 30 )
  1714. #define MAPI_DIAG_RENDITION_UNSUPPORTED             MAPI_DIAG( 31 )
  1715. #define MAPI_DIAG_MAIL_ADDRESS_INCORRECT            MAPI_DIAG( 32 )
  1716. #define MAPI_DIAG_MAIL_OFFICE_INCOR_OR_INVD         MAPI_DIAG( 33 )
  1717. #define MAPI_DIAG_MAIL_ADDRESS_INCOMPLETE           MAPI_DIAG( 34 )
  1718. #define MAPI_DIAG_MAIL_RECIPIENT_UNKNOWN            MAPI_DIAG( 35 )
  1719. #define MAPI_DIAG_MAIL_RECIPIENT_DECEASED           MAPI_DIAG( 36 )
  1720. #define MAPI_DIAG_MAIL_ORGANIZATION_EXPIRED         MAPI_DIAG( 37 )
  1721. #define MAPI_DIAG_MAIL_REFUSED                      MAPI_DIAG( 38 )
  1722. #define MAPI_DIAG_MAIL_UNCLAIMED                    MAPI_DIAG( 39 )
  1723. #define MAPI_DIAG_MAIL_RECIPIENT_MOVED              MAPI_DIAG( 40 )
  1724. #define MAPI_DIAG_MAIL_RECIPIENT_TRAVELLING         MAPI_DIAG( 41 )
  1725. #define MAPI_DIAG_MAIL_RECIPIENT_DEPARTED           MAPI_DIAG( 42 )
  1726. #define MAPI_DIAG_MAIL_NEW_ADDRESS_UNKNOWN          MAPI_DIAG( 43 )
  1727. #define MAPI_DIAG_MAIL_FORWARDING_UNWANTED          MAPI_DIAG( 44 )
  1728. #define MAPI_DIAG_MAIL_FORWARDING_PROHIB            MAPI_DIAG( 45 )
  1729. #define MAPI_DIAG_SECURE_MESSAGING_ERROR            MAPI_DIAG( 46 )
  1730. #define MAPI_DIAG_DOWNGRADING_IMPOSSIBLE            MAPI_DIAG( 47 )
  1733. #define MAPI_IMAILUSER_METHODS(IPURE)
  1735. #undef       INTERFACE
  1736. #define      INTERFACE  IMailUser
  1737. DECLARE_MAPI_INTERFACE_(IMailUser, IMAPIProp)
  1738. {
  1739.     BEGIN_INTERFACE
  1740.     MAPI_IUNKNOWN_METHODS(PURE)
  1741.     MAPI_IMAPIPROP_METHODS(PURE)
  1742.     MAPI_IMAILUSER_METHODS(PURE)
  1743. };
  1745. /* IDistList Interface ----------------------------------------------------- */
  1747. #define MAPI_IDISTLIST_METHODS(IPURE)                                   
  1748.     MAPIMETHOD(CreateEntry)                                             
  1749.         (THIS_  ULONG                       cbEntryID,                  
  1750.                 LPENTRYID                   lpEntryID,                  
  1751.                 ULONG                       ulCreateFlags,              
  1752.                 LPMAPIPROP FAR  *           lppMAPIPropEntry) IPURE;    
  1753.     MAPIMETHOD(CopyEntries)                                             
  1754.         (THIS_  LPENTRYLIST                 lpEntries,                  
  1755.                 ULONG                       ulUIParam,                  
  1756.                 LPMAPIPROGRESS              lpProgress,                 
  1757.                 ULONG                       ulFlags) IPURE;             
  1758.     MAPIMETHOD(DeleteEntries)                                           
  1759.         (THIS_  LPENTRYLIST                 lpEntries,                  
  1760.                 ULONG                       ulFlags) IPURE;             
  1761.     MAPIMETHOD(ResolveNames)                                            
  1762.         (THIS_  LPSPropTagArray             lpPropTagArray,             
  1763.                 ULONG                       ulFlags,                    
  1764.                 LPADRLIST                   lpAdrList,                  
  1765.                 LPFlagList                  lpFlagList) IPURE;          
  1767. #undef       INTERFACE
  1768. #define      INTERFACE  IDistList
  1769. DECLARE_MAPI_INTERFACE_(IDistList, IMAPIContainer)
  1770. {
  1771.     BEGIN_INTERFACE
  1772.     MAPI_IUNKNOWN_METHODS(PURE)
  1773.     MAPI_IMAPIPROP_METHODS(PURE)
  1774.     MAPI_IMAPICONTAINER_METHODS(PURE)
  1775.     MAPI_IDISTLIST_METHODS(PURE)
  1776. };
  1778. /* IMAPIFolder Interface --------------------------------------------------- */
  1780. /* IMAPIFolder folder type (enum) */
  1782. #define FOLDER_ROOT             ((ULONG) 0x00000000)
  1783. #define FOLDER_GENERIC          ((ULONG) 0x00000001)
  1784. #define FOLDER_SEARCH           ((ULONG) 0x00000002)
  1786. /* CreateMessage */
  1787. /****** MAPI_DEFERRED_ERRORS    ((ULONG) 0x00000008) below */
  1788. /****** MAPI_ASSOCIATED         ((ULONG) 0x00000040) below */
  1790. /* CopyMessages */
  1792. #define MESSAGE_MOVE            ((ULONG) 0x00000001)
  1793. #define MESSAGE_DIALOG          ((ULONG) 0x00000002)
  1794. /****** MAPI_DECLINE_OK         ((ULONG) 0x00000004) above */
  1796. /* CreateFolder */
  1798. #define OPEN_IF_EXISTS          ((ULONG) 0x00000001)
  1799. /****** MAPI_DEFERRED_ERRORS    ((ULONG) 0x00000008) below */
  1800. /****** MAPI_UNICODE            ((ULONG) 0x80000000) above */
  1802. /* DeleteFolder */
  1804. #define DEL_MESSAGES            ((ULONG) 0x00000001)
  1805. #define FOLDER_DIALOG           ((ULONG) 0x00000002)
  1806. #define DEL_FOLDERS             ((ULONG) 0x00000004)
  1808. /* EmptyFolder */
  1809. #define DEL_ASSOCIATED          ((ULONG) 0x00000008)
  1811. /* CopyFolder */
  1813. #define FOLDER_MOVE             ((ULONG) 0x00000001)
  1814. /****** FOLDER_DIALOG           ((ULONG) 0x00000002) above */
  1815. /****** MAPI_DECLINE_OK         ((ULONG) 0x00000004) above */
  1816. #define COPY_SUBFOLDERS         ((ULONG) 0x00000010)
  1817. /****** MAPI_UNICODE            ((ULONG) 0x80000000) above */
  1820. /* SetReadFlags */
  1822. /****** SUPPRESS_RECEIPT        ((ULONG) 0x00000001) below */
  1823. /****** MESSAGE_DIALOG          ((ULONG) 0x00000002) above */
  1824. /****** CLEAR_READ_FLAG         ((ULONG) 0x00000004) below */
  1825. /****** MAPI_DEFERRED_ERRORS    ((ULONG) 0x00000008) below */
  1826. #define GENERATE_RECEIPT_ONLY   ((ULONG) 0x00000010)
  1829. /* GetMessageStatus */
  1831. #define MSGSTATUS_HIGHLIGHTED   ((ULONG) 0x00000001)
  1832. #define MSGSTATUS_TAGGED        ((ULONG) 0x00000002)
  1833. #define MSGSTATUS_HIDDEN        ((ULONG) 0x00000004)
  1834. #define MSGSTATUS_DELMARKED     ((ULONG) 0x00000008)
  1836. /* Bits for remote message status */
  1838. #define MSGSTATUS_REMOTE_DOWNLOAD   ((ULONG) 0x00001000)
  1839. #define MSGSTATUS_REMOTE_DELETE     ((ULONG) 0x00002000)
  1841. /* SaveContentsSort */
  1843. #define RECURSIVE_SORT          ((ULONG) 0x00000002)
  1845. /* PR_STATUS property */
  1847. #define FLDSTATUS_HIGHLIGHTED   ((ULONG) 0x00000001)
  1848. #define FLDSTATUS_TAGGED        ((ULONG) 0x00000002)
  1849. #define FLDSTATUS_HIDDEN        ((ULONG) 0x00000004)
  1850. #define FLDSTATUS_DELMARKED     ((ULONG) 0x00000008)
  1852. #define MAPI_IMAPIFOLDER_METHODS(IPURE)                                 
  1853.     MAPIMETHOD(CreateMessage)                                           
  1854.         (THIS_  LPCIID                      lpInterface,                
  1855.                 ULONG                       ulFlags,                    
  1856.                 LPMESSAGE FAR *             lppMessage) IPURE;          
  1857.     MAPIMETHOD(CopyMessages)                                            
  1858.         (THIS_  LPENTRYLIST                 lpMsgList,                  
  1859.                 LPCIID                      lpInterface,                
  1860.                 LPVOID                      lpDestFolder,               
  1861.                 ULONG                       ulUIParam,                  
  1862.                 LPMAPIPROGRESS              lpProgress,                 
  1863.                 ULONG                       ulFlags) IPURE;             
  1864.     MAPIMETHOD(DeleteMessages)                                          
  1865.         (THIS_  LPENTRYLIST                 lpMsgList,                  
  1866.                 ULONG                       ulUIParam,                  
  1867.                 LPMAPIPROGRESS              lpProgress,                 
  1868.                 ULONG                       ulFlags) IPURE;             
  1869.     MAPIMETHOD(CreateFolder)                                            
  1870.         (THIS_  ULONG                       ulFolderType,               
  1871.                 LPTSTR                      lpszFolderName,             
  1872.                 LPTSTR                      lpszFolderComment,          
  1873.                 LPCIID                      lpInterface,                
  1874.                 ULONG                       ulFlags,                    
  1875.                 LPMAPIFOLDER FAR *          lppFolder) IPURE;           
  1876.     MAPIMETHOD(CopyFolder)                                              
  1877.         (THIS_  ULONG                       cbEntryID,                  
  1878.                 LPENTRYID                   lpEntryID,                  
  1879.                 LPCIID                      lpInterface,                
  1880.                 LPVOID                      lpDestFolder,               
  1881.                 LPTSTR                      lpszNewFolderName,          
  1882.                 ULONG                       ulUIParam,                  
  1883.                 LPMAPIPROGRESS              lpProgress,                 
  1884.                 ULONG                       ulFlags) IPURE;             
  1885.     MAPIMETHOD(DeleteFolder)                                            
  1886.         (THIS_  ULONG                       cbEntryID,                  
  1887.                 LPENTRYID                   lpEntryID,                  
  1888.                 ULONG                       ulUIParam,                  
  1889.                 LPMAPIPROGRESS              lpProgress,                 
  1890.                 ULONG                       ulFlags) IPURE;             
  1891.     MAPIMETHOD(SetReadFlags)                                            
  1892.         (THIS_  LPENTRYLIST                 lpMsgList,                  
  1893.                 ULONG                       ulUIParam,                  
  1894.                 LPMAPIPROGRESS              lpProgress,                 
  1895.                 ULONG                       ulFlags) IPURE;             
  1896.     MAPIMETHOD(GetMessageStatus)                                        
  1897.         (THIS_  ULONG                       cbEntryID,                  
  1898.                 LPENTRYID                   lpEntryID,                  
  1899.                 ULONG                       ulFlags,                    
  1900.                 ULONG FAR *                 lpulMessageStatus) IPURE;   
  1901.     MAPIMETHOD(SetMessageStatus)                                        
  1902.         (THIS_  ULONG                       cbEntryID,                  
  1903.                 LPENTRYID                   lpEntryID,                  
  1904.                 ULONG                       ulNewStatus,                
  1905.                 ULONG                       ulNewStatusMask,            
  1906.                 ULONG FAR *                 lpulOldStatus) IPURE;       
  1907.     MAPIMETHOD(SaveContentsSort)                                        
  1908.         (THIS_  LPSSortOrderSet             lpSortCriteria,             
  1909.                 ULONG                       ulFlags) IPURE;             
  1910.     MAPIMETHOD(EmptyFolder)                                             
  1911.         (THIS_  ULONG                       ulUIParam,                  
  1912.                 LPMAPIPROGRESS              lpProgress,                 
  1913.                 ULONG                       ulFlags) IPURE;             
  1915. #undef       INTERFACE
  1916. #define      INTERFACE  IMAPIFolder
  1917. DECLARE_MAPI_INTERFACE_(IMAPIFolder, IMAPIContainer)
  1918. {
  1919.     BEGIN_INTERFACE
  1920.     MAPI_IUNKNOWN_METHODS(PURE)
  1921.     MAPI_IMAPIPROP_METHODS(PURE)
  1922.     MAPI_IMAPICONTAINER_METHODS(PURE)
  1923.     MAPI_IMAPIFOLDER_METHODS(PURE)
  1924. };
  1926. /* IMsgStore Interface ----------------------------------------------------- */
  1928. /*  PR_STORE_SUPPORT_MASK bits */
  1929. #define STORE_ENTRYID_UNIQUE    ((ULONG) 0x00000001)
  1930. #define STORE_READONLY          ((ULONG) 0x00000002)
  1931. #define STORE_SEARCH_OK         ((ULONG) 0x00000004)
  1932. #define STORE_MODIFY_OK         ((ULONG) 0x00000008)
  1933. #define STORE_CREATE_OK         ((ULONG) 0x00000010)
  1934. #define STORE_ATTACH_OK         ((ULONG) 0x00000020)
  1935. #define STORE_OLE_OK            ((ULONG) 0x00000040)
  1936. #define STORE_SUBMIT_OK         ((ULONG) 0x00000080)
  1937. #define STORE_NOTIFY_OK         ((ULONG) 0x00000100)
  1938. #define STORE_MV_PROPS_OK       ((ULONG) 0x00000200)
  1939. #define STORE_CATEGORIZE_OK     ((ULONG) 0x00000400)
  1940. #define STORE_RTF_OK            ((ULONG) 0x00000800)
  1941. #define STORE_RESTRICTION_OK    ((ULONG) 0x00001000)
  1942. #define STORE_SORT_OK           ((ULONG) 0x00002000)
  1944. /* PR_STORE_STATE bits, try not to collide with PR_STORE_SUPPORT_MASK */
  1946. #define STORE_HAS_SEARCHES      ((ULONG) 0x01000000)
  1949. /* OpenEntry() */
  1951. /****** MAPI_MODIFY             ((ULONG) 0x00000001) above */
  1952. /****** MAPI_DEFERRED_ERRORS    ((ULONG) 0x00000008) below */
  1953. /****** MAPI_BEST_ACCESS        ((ULONG) 0x00000010) above */
  1955. /* SetReceiveFolder() */
  1957. /****** MAPI_UNICODE            ((ULONG) 0x80000000) above */
  1959. /* GetReceiveFolder() */
  1961. /****** MAPI_UNICODE            ((ULONG) 0x80000000) above */
  1963. /* GetReceiveFolderTable() */
  1965. /****** MAPI_DEFERRED_ERRORS    ((ULONG) 0x00000008) below */
  1967. /* StoreLogoff() */
  1969. #define LOGOFF_NO_WAIT          ((ULONG) 0x00000001)
  1970. #define LOGOFF_ORDERLY          ((ULONG) 0x00000002)
  1971. #define LOGOFF_PURGE            ((ULONG) 0x00000004)
  1972. #define LOGOFF_ABORT            ((ULONG) 0x00000008)
  1973. #define LOGOFF_QUIET            ((ULONG) 0x00000010)
  1975. #define LOGOFF_COMPLETE         ((ULONG) 0x00010000)
  1976. #define LOGOFF_INBOUND          ((ULONG) 0x00020000)
  1977. #define LOGOFF_OUTBOUND         ((ULONG) 0x00040000)
  1978. #define LOGOFF_OUTBOUND_QUEUE   ((ULONG) 0x00080000)
  1980. /* SetLockState() */
  1982. #define MSG_LOCKED              ((ULONG) 0x00000001)
  1983. #define MSG_UNLOCKED            ((ULONG) 0x00000000)
  1985. /* Flag bits for PR_VALID_FOLDER_MASK */
  1987. #define FOLDER_IPM_SUBTREE_VALID        ((ULONG) 0x00000001)
  1988. #define FOLDER_IPM_INBOX_VALID          ((ULONG) 0x00000002)
  1989. #define FOLDER_IPM_OUTBOX_VALID         ((ULONG) 0x00000004)
  1990. #define FOLDER_IPM_WASTEBASKET_VALID    ((ULONG) 0x00000008)
  1991. #define FOLDER_IPM_SENTMAIL_VALID       ((ULONG) 0x00000010)
  1992. #define FOLDER_VIEWS_VALID              ((ULONG) 0x00000020)
  1993. #define FOLDER_COMMON_VIEWS_VALID       ((ULONG) 0x00000040)
  1994. #define FOLDER_FINDER_VALID             ((ULONG) 0x00000080)
  1996. #define MAPI_IMSGSTORE_METHODS(IPURE)                                   
  1997.     MAPIMETHOD(Advise)                                                  
  1998.         (THIS_  ULONG                       cbEntryID,                  
  1999.                 LPENTRYID                   lpEntryID,                  
  2000.                 ULONG                       ulEventMask,                
  2001.                 LPMAPIADVISESINK            lpAdviseSink,               
  2002.                 ULONG FAR *                 lpulConnection) IPURE;      
  2003.     MAPIMETHOD(Unadvise)                                                
  2004.         (THIS_  ULONG                       ulConnection) IPURE;        
  2005.     MAPIMETHOD(CompareEntryIDs)                                         
  2006.         (THIS_  ULONG                       cbEntryID1,                 
  2007.                 LPENTRYID                   lpEntryID1,                 
  2008.                 ULONG                       cbEntryID2,                 
  2009.                 LPENTRYID                   lpEntryID2,                 
  2010.                 ULONG                       ulFlags,                    
  2011.                 ULONG FAR *                 lpulResult) IPURE;          
  2012.     MAPIMETHOD(OpenEntry)                                               
  2013.         (THIS_  ULONG                       cbEntryID,                  
  2014.                 LPENTRYID                   lpEntryID,                  
  2015.                 LPCIID                      lpInterface,                
  2016.                 ULONG                       ulFlags,                    
  2017.                 ULONG FAR *                 lpulObjType,                
  2018.                 LPUNKNOWN FAR *             lppUnk) IPURE;              
  2019.     MAPIMETHOD(SetReceiveFolder)                                        
  2020.         (THIS_  LPTSTR                      lpszMessageClass,           
  2021.                 ULONG                       ulFlags,                    
  2022.                 ULONG                       cbEntryID,                  
  2023.                 LPENTRYID                   lpEntryID) IPURE;           
  2024.     MAPIMETHOD(GetReceiveFolder)                                        
  2025.         (THIS_  LPTSTR                      lpszMessageClass,           
  2026.                 ULONG                       ulFlags,                    
  2027.                 ULONG FAR *                 lpcbEntryID,                
  2028.                 LPENTRYID FAR *             lppEntryID,                 
  2029.                 LPTSTR FAR *                lppszExplicitClass) IPURE;  
  2030.     MAPIMETHOD(GetReceiveFolderTable)                                   
  2031.         (THIS_  ULONG                       ulFlags,                    
  2032.                 LPMAPITABLE FAR *           lppTable) IPURE;            
  2033.     MAPIMETHOD(StoreLogoff)                                             
  2034.         (THIS_  ULONG FAR *                 lpulFlags) IPURE;           
  2035.     MAPIMETHOD(AbortSubmit)                                             
  2036.         (THIS_  ULONG                       cbEntryID,                  
  2037.                 LPENTRYID                   lpEntryID,                  
  2038.                 ULONG                       ulFlags) IPURE;             
  2039.     MAPIMETHOD(GetOutgoingQueue)                                        
  2040.         (THIS_  ULONG                       ulFlags,                    
  2041.                 LPMAPITABLE FAR *           lppTable) IPURE;            
  2042.     MAPIMETHOD(SetLockState)                                            
  2043.         (THIS_  LPMESSAGE                   lpMessage,                  
  2044.                 ULONG                       ulLockState) IPURE;         
  2045.     MAPIMETHOD(FinishedMsg)                                             
  2046.         (THIS_  ULONG                       ulFlags,                    
  2047.                 ULONG                       cbEntryID,                  
  2048.                 LPENTRYID                   lpEntryID) IPURE;           
  2049.     MAPIMETHOD(NotifyNewMail)                                           
  2050.         (THIS_  LPNOTIFICATION              lpNotification) IPURE;      
  2052. #undef       INTERFACE
  2053. #define      INTERFACE  IMsgStore
  2054. DECLARE_MAPI_INTERFACE_(IMsgStore, IMAPIProp)
  2055. {
  2056.     BEGIN_INTERFACE
  2057.     MAPI_IUNKNOWN_METHODS(PURE)
  2058.     MAPI_IMAPIPROP_METHODS(PURE)
  2059.     MAPI_IMSGSTORE_METHODS(PURE)
  2060. };
  2062. /* IMessage Interface ------------------------------------------------------ */
  2064. /* SubmitMessage */
  2066. #define FORCE_SUBMIT                ((ULONG) 0x00000001)
  2068. /* Flags defined in PR_MESSAGE_FLAGS */
  2070. #define MSGFLAG_READ            ((ULONG) 0x00000001)
  2071. #define MSGFLAG_UNMODIFIED      ((ULONG) 0x00000002)
  2072. #define MSGFLAG_SUBMIT          ((ULONG) 0x00000004)
  2073. #define MSGFLAG_UNSENT          ((ULONG) 0x00000008)
  2074. #define MSGFLAG_HASATTACH       ((ULONG) 0x00000010)
  2075. #define MSGFLAG_FROMME          ((ULONG) 0x00000020)
  2076. #define MSGFLAG_ASSOCIATED      ((ULONG) 0x00000040)
  2077. #define MSGFLAG_RESEND          ((ULONG) 0x00000080)
  2078. #define MSGFLAG_RN_PENDING ((ULONG) 0x00000100)
  2079. #define MSGFLAG_NRN_PENDING ((ULONG) 0x00000200)
  2081. /* Flags defined in PR_SUBMIT_FLAGS */
  2083. #define SUBMITFLAG_LOCKED       ((ULONG) 0x00000001)
  2084. #define SUBMITFLAG_PREPROCESS   ((ULONG) 0x00000002)
  2086. /* GetAttachmentTable() */
  2087. /****** MAPI_UNICODE            ((ULONG) 0x80000000) above */
  2089. /* GetRecipientTable() */
  2090. /****** MAPI_UNICODE            ((ULONG) 0x80000000) above */
  2092. /* ModifyRecipients */
  2094. /* ((ULONG) 0x00000001 is not a valid flag on ModifyRecipients. */
  2095. #define MODRECIP_ADD            ((ULONG) 0x00000002)
  2096. #define MODRECIP_MODIFY         ((ULONG) 0x00000004)
  2097. #define MODRECIP_REMOVE         ((ULONG) 0x00000008)
  2099. /* SetReadFlag */
  2101. #define SUPPRESS_RECEIPT        ((ULONG) 0x00000001)
  2102. #define CLEAR_READ_FLAG         ((ULONG) 0x00000004)
  2103. /****** MAPI_DEFERRED_ERRORS    ((ULONG) 0x00000008) below */
  2104. /****** GENERATE_RECEIPT_ONLY   ((ULONG) 0x00000010) above */
  2105. #define GENERATE_RECEIPT_ONLY ((ULONG) 0x00000010)
  2106. #define CLEAR_RN_PENDING ((ULONG) 0x00000020)
  2107. #define CLEAR_NRN_PENDING ((ULONG) 0x00000040)
  2109. /* DeleteAttach */
  2111. #define ATTACH_DIALOG           ((ULONG) 0x00000001)
  2113. /* PR_SECURITY values */
  2114. #define SECURITY_SIGNED         ((ULONG) 0x00000001)
  2115. #define SECURITY_ENCRYPTED      ((ULONG) 0x00000002)
  2117. /* PR_PRIORITY values */
  2118. #define PRIO_URGENT             ((long)  1)
  2119. #define PRIO_NORMAL             ((long)  0)
  2120. #define PRIO_NONURGENT          ((long) -1)
  2122. /* PR_SENSITIVITY values */
  2123. #define SENSITIVITY_NONE                    ((ULONG) 0x00000000)
  2124. #define SENSITIVITY_PERSONAL                ((ULONG) 0x00000001)
  2125. #define SENSITIVITY_PRIVATE                 ((ULONG) 0x00000002)
  2126. #define SENSITIVITY_COMPANY_CONFIDENTIAL    ((ULONG) 0x00000003)
  2128. /* PR_IMPORTANCE values */
  2129. #define IMPORTANCE_LOW          ((long) 0)
  2130. #define IMPORTANCE_NORMAL       ((long) 1)
  2131. #define IMPORTANCE_HIGH         ((long) 2)
  2133. #define MAPI_IMESSAGE_METHODS(IPURE)                                    
  2134.     MAPIMETHOD(GetAttachmentTable)                                      
  2135.         (THIS_  ULONG                       ulFlags,                    
  2136.                 LPMAPITABLE FAR *           lppTable) IPURE;            
  2137.     MAPIMETHOD(OpenAttach)                                              
  2138.         (THIS_  ULONG                       ulAttachmentNum,            
  2139.                 LPCIID                      lpInterface,                
  2140.                 ULONG                       ulFlags,                    
  2141.                 LPATTACH FAR *              lppAttach) IPURE;           
  2142.     MAPIMETHOD(CreateAttach)                                            
  2143.         (THIS_  LPCIID                      lpInterface,                
  2144.                 ULONG                       ulFlags,                    
  2145.                 ULONG FAR *                 lpulAttachmentNum,          
  2146.                 LPATTACH FAR *              lppAttach) IPURE;           
  2147.     MAPIMETHOD(DeleteAttach)                                            
  2148.         (THIS_  ULONG                       ulAttachmentNum,            
  2149.                 ULONG                       ulUIParam,                  
  2150.                 LPMAPIPROGRESS              lpProgress,                 
  2151.                 ULONG                       ulFlags) IPURE;             
  2152.     MAPIMETHOD(GetRecipientTable)                                       
  2153.         (THIS_  ULONG                       ulFlags,                    
  2154.                 LPMAPITABLE FAR *           lppTable) IPURE;            
  2155.     MAPIMETHOD(ModifyRecipients)                                        
  2156.         (THIS_  ULONG                       ulFlags,                    
  2157.                 LPADRLIST                   lpMods) IPURE;              
  2158.     MAPIMETHOD(SubmitMessage)                                           
  2159.         (THIS_  ULONG                       ulFlags) IPURE;             
  2160.     MAPIMETHOD(SetReadFlag)                                             
  2161.         (THIS_  ULONG                       ulFlags) IPURE;             
  2163. #undef       INTERFACE
  2164. #define      INTERFACE  IMessage
  2165. DECLARE_MAPI_INTERFACE_(IMessage, IMAPIProp)
  2166. {
  2167.     BEGIN_INTERFACE
  2168.     MAPI_IUNKNOWN_METHODS(PURE)
  2169.     MAPI_IMAPIPROP_METHODS(PURE)
  2170.     MAPI_IMESSAGE_METHODS(PURE)
  2171. };
  2173. /* IAttach Interface ------------------------------------------------------- */
  2175. /* IAttach attachment methods: PR_ATTACH_METHOD values */
  2177. #define NO_ATTACHMENT           ((ULONG) 0x00000000)
  2178. #define ATTACH_BY_VALUE         ((ULONG) 0x00000001)
  2179. #define ATTACH_BY_REFERENCE     ((ULONG) 0x00000002)
  2180. #define ATTACH_BY_REF_RESOLVE   ((ULONG) 0x00000003)
  2181. #define ATTACH_BY_REF_ONLY      ((ULONG) 0x00000004)
  2182. #define ATTACH_EMBEDDED_MSG     ((ULONG) 0x00000005)
  2183. #define ATTACH_OLE              ((ULONG) 0x00000006)
  2185. #define MAPI_IATTACH_METHODS(IPURE)
  2187. #undef       INTERFACE
  2188. #define      INTERFACE  IAttach
  2189. DECLARE_MAPI_INTERFACE_(IAttach, IMAPIProp)
  2190. {
  2191.     BEGIN_INTERFACE
  2192.     MAPI_IUNKNOWN_METHODS(PURE)
  2193.     MAPI_IMAPIPROP_METHODS(PURE)
  2194.     MAPI_IATTACH_METHODS(PURE)
  2195. };
  2197. /* --------------------------------- */
  2198. /* Address Book interface definition */
  2200. /* ADRPARM ulFlags - top 4 bits used for versioning */
  2202. #define GET_ADRPARM_VERSION(ulFlags)  (((ULONG)ulFlags) & 0xF0000000)
  2203. #define SET_ADRPARM_VERSION(ulFlags, ulVersion)  (((ULONG)ulVersion) | (((ULONG)ulFlags) & 0x0FFFFFFF))
  2205. /*  Current versions of ADRPARM  */
  2206. #define ADRPARM_HELP_CTX        ((ULONG) 0x00000000)
  2209. /*  ulFlags   - bit fields */
  2210. #define DIALOG_MODAL            ((ULONG) 0x00000001)
  2211. #define DIALOG_SDI              ((ULONG) 0x00000002)
  2212. #define DIALOG_OPTIONS          ((ULONG) 0x00000004)
  2213. #define ADDRESS_ONE             ((ULONG) 0x00000008)
  2214. #define AB_SELECTONLY           ((ULONG) 0x00000010)
  2215. #define AB_RESOLVE              ((ULONG) 0x00000020)
  2217. /* --------------------------------- */
  2218. /*  PR_DISPLAY_TYPEs                 */
  2219. /*
  2220.  *  These standard display types are
  2221.  *  by default handled by MAPI.
  2222.  *  They have default icons associated
  2223.  *  with them.
  2224.  */
  2226. /*  For address book contents tables */
  2227. #define DT_MAILUSER         ((ULONG) 0x00000000)
  2228. #define DT_DISTLIST         ((ULONG) 0x00000001)
  2229. #define DT_FORUM            ((ULONG) 0x00000002)
  2230. #define DT_AGENT            ((ULONG) 0x00000003)
  2231. #define DT_ORGANIZATION     ((ULONG) 0x00000004)
  2232. #define DT_PRIVATE_DISTLIST ((ULONG) 0x00000005)
  2233. #define DT_REMOTE_MAILUSER  ((ULONG) 0x00000006)
  2235. /*  For address book hierarchy tables */
  2236. #define DT_MODIFIABLE       ((ULONG) 0x00010000)
  2237. #define DT_GLOBAL           ((ULONG) 0x00020000)
  2238. #define DT_LOCAL            ((ULONG) 0x00030000)
  2239. #define DT_WAN              ((ULONG) 0x00040000)
  2240. #define DT_NOT_SPECIFIC     ((ULONG) 0x00050000)
  2242. /*  For folder hierarchy tables */
  2243. #define DT_FOLDER           ((ULONG) 0x01000000)
  2244. #define DT_FOLDER_LINK      ((ULONG) 0x02000000)
  2246. /*  Accelerator callback for DIALOG_SDI form of AB UI */
  2247. typedef BOOL (STDMETHODCALLTYPE ACCELERATEABSDI)(ULONG ulUIParam,
  2248.                                                 LPVOID lpvmsg);
  2249. typedef ACCELERATEABSDI FAR * LPFNABSDI;
  2251. /*  Callback to application telling it that the DIALOG_SDI form of the */
  2252. /*  AB UI has been dismissed.  This is so that the above LPFNABSDI     */
  2253. /*  function doesn't keep being called.                                */
  2254. typedef void (STDMETHODCALLTYPE DISMISSMODELESS)(ULONG ulUIParam,
  2255.                                                 LPVOID lpvContext);
  2256. typedef DISMISSMODELESS FAR * LPFNDISMISS;
  2258. /*
  2259.  * Prototype for the client function hooked to an optional button on
  2260.  * the address book dialog
  2261.  */
  2263. typedef SCODE (STDMETHODCALLTYPE FAR * LPFNBUTTON)(
  2264.     ULONG               ulUIParam,
  2265.     LPVOID              lpvContext,
  2266.     ULONG               cbEntryID,
  2267.     LPENTRYID           lpSelection,
  2268.     ULONG               ulFlags
  2269. );
  2272. /* Parameters for the address book dialog */
  2273. typedef struct _ADRPARM
  2274. {
  2275.     ULONG           cbABContEntryID;
  2276.     LPENTRYID       lpABContEntryID;
  2277.     ULONG           ulFlags;
  2279.     LPVOID          lpReserved;
  2280.     ULONG           ulHelpContext;
  2281.     LPTSTR          lpszHelpFileName;
  2283.     LPFNABSDI       lpfnABSDI;
  2284.     LPFNDISMISS     lpfnDismiss;
  2285.     LPVOID          lpvDismissContext;
  2286.     LPTSTR          lpszCaption;
  2287.     LPTSTR          lpszNewEntryTitle;
  2288.     LPTSTR          lpszDestWellsTitle;
  2289.     ULONG           cDestFields;
  2290.     ULONG           nDestFieldFocus;
  2291.     LPTSTR FAR *    lppszDestTitles;
  2292.     ULONG FAR *     lpulDestComps;
  2293.     LPSRestriction  lpContRestriction;
  2294.     LPSRestriction  lpHierRestriction;
  2295. } ADRPARM, FAR * LPADRPARM;
  2298. /* ------------ */
  2299. /* Random flags */
  2301. /* Flag set in MAPI one off entryids */
  2302. #define MAPI_ONE_OFF_NO_RICH_INFO 0x0001
  2304. /* Flag for deferred error */
  2305. #define MAPI_DEFERRED_ERRORS    ((ULONG) 0x00000008)
  2307. /* Flag for creating and using Folder Associated Information Messages */
  2308. #define MAPI_ASSOCIATED         ((ULONG) 0x00000040)
  2310. /* Flags for OpenMessageStore() */
  2312. #define MDB_NO_DIALOG           ((ULONG) 0x00000001)
  2313. #define MDB_WRITE               ((ULONG) 0x00000004)
  2314. /****** MAPI_DEFERRED_ERRORS    ((ULONG) 0x00000008) above */
  2315. /****** MAPI_BEST_ACCESS        ((ULONG) 0x00000010) above */
  2316. #define MDB_TEMPORARY           ((ULONG) 0x00000020)
  2317. #define MDB_NO_MAIL             ((ULONG) 0x00000080)
  2319. /* Flags for OpenAddressBook */
  2321. #define AB_NO_DIALOG            ((ULONG) 0x00000001)
  2323. /* IMAPIControl Interface -------------------------------------------------- */
  2325. /* Interface used in controls (particularly the button) defined by */
  2326. /* Display Tables. */
  2328. /*  Flags for GetState */
  2330. #define  MAPI_ENABLED       ((ULONG) 0x00000000)
  2331. #define  MAPI_DISABLED      ((ULONG) 0x00000001)
  2333. #define MAPI_IMAPICONTROL_METHODS(IPURE)                                
  2334.     MAPIMETHOD(GetLastError)                                            
  2335.         (THIS_  HRESULT                     hResult,                    
  2336.                 ULONG                       ulFlags,                    
  2337.                 LPMAPIERROR FAR *           lppMAPIError) IPURE;        
  2338.     MAPIMETHOD(Activate)                                                
  2339.         (THIS_  ULONG                       ulFlags,                    
  2340.                 ULONG                       ulUIParam) IPURE;           
  2341.     MAPIMETHOD(GetState)                                                
  2342.         (THIS_  ULONG                       ulFlags,                    
  2343.                 ULONG FAR *                 lpulState) IPURE;           
  2345. #undef       INTERFACE
  2346. #define      INTERFACE  IMAPIControl
  2347. DECLARE_MAPI_INTERFACE_(IMAPIControl, IUnknown)
  2348. {
  2349.     BEGIN_INTERFACE
  2350.     MAPI_IUNKNOWN_METHODS(PURE)
  2351.     MAPI_IMAPICONTROL_METHODS(PURE)
  2352. };
  2354. DECLARE_MAPI_INTERFACE_PTR(IMAPIControl, LPMAPICONTROL);
  2356. /* Display Tables ---------------------------------------------------------- */
  2358. /* Flags used in display tables - that is, PR_CONTROL_FLAGS */
  2360. #define DT_MULTILINE        ((ULONG) 0x00000001)
  2361. #define DT_EDITABLE         ((ULONG) 0x00000002)
  2362. #define DT_REQUIRED         ((ULONG) 0x00000004)
  2363. #define DT_SET_IMMEDIATE    ((ULONG) 0x00000008)
  2364. #define DT_PASSWORD_EDIT    ((ULONG) 0x00000010)
  2365. #define DT_ACCEPT_DBCS      ((ULONG) 0x00000020)
  2366. #define DT_SET_SELECTION    ((ULONG) 0x00000040)
  2368. /* Display Table structures */
  2370. #define DTCT_LABEL          ((ULONG) 0x00000000)
  2371. #define DTCT_EDIT           ((ULONG) 0x00000001)
  2372. #define DTCT_LBX            ((ULONG) 0x00000002)
  2373. #define DTCT_COMBOBOX       ((ULONG) 0x00000003)
  2374. #define DTCT_DDLBX          ((ULONG) 0x00000004)
  2375. #define DTCT_CHECKBOX       ((ULONG) 0x00000005)
  2376. #define DTCT_GROUPBOX       ((ULONG) 0x00000006)
  2377. #define DTCT_BUTTON         ((ULONG) 0x00000007)
  2378. #define DTCT_PAGE           ((ULONG) 0x00000008)
  2379. #define DTCT_RADIOBUTTON    ((ULONG) 0x00000009)
  2380. #define DTCT_MVLISTBOX      ((ULONG) 0x0000000B)
  2381. #define DTCT_MVDDLBX        ((ULONG) 0x0000000C)
  2383. /* Labels */
  2384. /* Valid ulFlags:
  2385.  *   MAPI_UNICODE
  2386.  */
  2387. typedef struct _DTBLLABEL
  2388. {
  2389.     ULONG ulbLpszLabelName;
  2390.     ULONG ulFlags;
  2391. } DTBLLABEL, FAR * LPDTBLLABEL;
  2392. #define SizedDtblLabel(n,u) 
  2393. struct _DTBLLABEL_ ## u 
  2394. { 
  2395.     DTBLLABEL   dtbllabel; 
  2396.     TCHAR       lpszLabelName[n]; 
  2397. } u
  2400. /*  Simple Text Edits  */
  2401. /* Valid ulFlags:
  2402.  *   MAPI_UNICODE
  2403.  */
  2404. typedef struct _DTBLEDIT
  2405. {
  2406.     ULONG ulbLpszCharsAllowed;
  2407.     ULONG ulFlags;
  2408.     ULONG ulNumCharsAllowed;
  2409.     ULONG ulPropTag;
  2410. } DTBLEDIT, FAR * LPDTBLEDIT;
  2411. #define SizedDtblEdit(n,u) 
  2412. struct _DTBLEDIT_ ## u 
  2413. { 
  2414.     DTBLEDIT    dtbledit; 
  2415.     TCHAR       lpszCharsAllowed[n]; 
  2416. } u
  2418. /*  List Box  */
  2419. /* Valid ulFlags:
  2420.  */
  2421. #define MAPI_NO_HBAR        ((ULONG) 0x00000001)
  2422. #define MAPI_NO_VBAR        ((ULONG) 0x00000002)
  2424. typedef struct _DTBLLBX
  2425. {
  2426.     ULONG ulFlags;
  2427.     ULONG ulPRSetProperty;
  2428.     ULONG ulPRTableName;
  2429. } DTBLLBX, FAR * LPDTBLLBX;
  2432. /*  Combo Box   */
  2433. /* Valid ulFlags:
  2434.  *   MAPI_UNICODE
  2435.  */
  2436. typedef struct _DTBLCOMBOBOX
  2437. {
  2438.     ULONG ulbLpszCharsAllowed;
  2439.     ULONG ulFlags;
  2440.     ULONG ulNumCharsAllowed;
  2441.     ULONG ulPRPropertyName;
  2442.     ULONG ulPRTableName;
  2443. } DTBLCOMBOBOX, FAR * LPDTBLCOMBOBOX;
  2444. #define SizedDtblComboBox(n,u) 
  2445. struct _DTBLCOMBOBOX_ ## u 
  2446. { 
  2447.     DTBLCOMBOBOX    dtblcombobox; 
  2448.     TCHAR           lpszCharsAllowed[n]; 
  2449. } u
  2452. /*  Drop Down   */
  2453. /* Valid ulFlags:
  2454.  *   none
  2455.  */
  2456. typedef struct _DTBLDDLBX
  2457. {
  2458.     ULONG ulFlags;
  2459.     ULONG ulPRDisplayProperty;
  2460.     ULONG ulPRSetProperty;
  2461.     ULONG ulPRTableName;
  2462. } DTBLDDLBX, FAR * LPDTBLDDLBX;
  2465. /*  Check Box   */
  2466. /* Valid ulFlags:
  2467.  *   MAPI_UNICODE
  2468.  */
  2469. typedef struct _DTBLCHECKBOX
  2470. {
  2471.     ULONG ulbLpszLabel;
  2472.     ULONG ulFlags;
  2473.     ULONG ulPRPropertyName;
  2474. } DTBLCHECKBOX, FAR * LPDTBLCHECKBOX;
  2475. #define SizedDtblCheckBox(n,u) 
  2476. struct _DTBLCHECKBOX_ ## u 
  2477. { 
  2478.     DTBLCHECKBOX    dtblcheckbox; 
  2479.     TCHAR       lpszLabel[n]; 
  2480. } u
  2484. /*  Group Box   */
  2485. /* Valid ulFlags:
  2486.  *   MAPI_UNICODE
  2487.  */
  2488. typedef struct _DTBLGROUPBOX
  2489. {
  2490.     ULONG ulbLpszLabel;
  2491.     ULONG ulFlags;
  2492. } DTBLGROUPBOX, FAR * LPDTBLGROUPBOX;
  2493. #define SizedDtblGroupBox(n,u) 
  2494. struct _DTBLGROUPBOX_ ## u 
  2495. { 
  2496.     DTBLGROUPBOX    dtblgroupbox; 
  2497.     TCHAR           lpszLabel[n]; 
  2498. } u
  2500. /*  Button control   */
  2501. /* Valid ulFlags:
  2502.  *   MAPI_UNICODE
  2503.  */
  2504. typedef struct _DTBLBUTTON
  2505. {
  2506.     ULONG ulbLpszLabel;
  2507.     ULONG ulFlags;
  2508.     ULONG ulPRControl;
  2509. } DTBLBUTTON, FAR * LPDTBLBUTTON;
  2510. #define SizedDtblButton(n,u) 
  2511. struct _DTBLBUTTON_ ## u 
  2512. { 
  2513.     DTBLBUTTON  dtblbutton; 
  2514.     TCHAR       lpszLabel[n]; 
  2515. } u
  2517. /*  Pages   */
  2518. /* Valid ulFlags:
  2519.  *   MAPI_UNICODE
  2520.  */
  2521. typedef struct _DTBLPAGE
  2522. {
  2523.     ULONG ulbLpszLabel;
  2524.     ULONG ulFlags;
  2525.     ULONG ulbLpszComponent;
  2526.     ULONG ulContext;
  2527. } DTBLPAGE, FAR * LPDTBLPAGE;
  2528. #define SizedDtblPage(n,n1,u) 
  2529. struct _DTBLPAGE_ ## u 
  2530. { 
  2531.     DTBLPAGE    dtblpage; 
  2532.     TCHAR       lpszLabel[n]; 
  2533.     TCHAR       lpszComponent[n1]; 
  2534. } u
  2536. /*  Radio button   */
  2537. /* Valid ulFlags:
  2538.  *   MAPI_UNICODE
  2539.  */
  2540. typedef struct _DTBLRADIOBUTTON
  2541. {
  2542.     ULONG ulbLpszLabel;
  2543.     ULONG ulFlags;
  2544.     ULONG ulcButtons;
  2545.     ULONG ulPropTag;
  2546.     long lReturnValue;
  2547. } DTBLRADIOBUTTON, FAR * LPDTBLRADIOBUTTON;
  2548. #define SizedDtblRadioButton(n,u) 
  2549. struct _DTBLRADIOBUTTON_ ## u 
  2550. { 
  2551.     DTBLRADIOBUTTON dtblradiobutton; 
  2552.     TCHAR           lpszLabel[n]; 
  2553. } u
  2556. /*  MultiValued listbox */
  2557. /* Valid ulFlags:
  2558.  *   none
  2559.  */
  2560. typedef struct _DTBLMVLISTBOX
  2561. {
  2562.     ULONG ulFlags;
  2563.     ULONG ulMVPropTag;
  2564. } DTBLMVLISTBOX, FAR * LPDTBLMVLISTBOX;
  2567. /*  MultiValued dropdown */
  2568. /* Valid ulFlags:
  2569.  *   none
  2570.  */
  2571. typedef struct _DTBLMVDDLBX
  2572. {
  2573.     ULONG ulFlags;
  2574.     ULONG ulMVPropTag;
  2575. } DTBLMVDDLBX, FAR * LPDTBLMVDDLBX;
  2581. /* IProviderAdmin Interface ---------------------------------------------- */
  2583. /* Flags for ConfigureMsgService */
  2585. #define UI_SERVICE                  0x00000002
  2586. #define SERVICE_UI_ALWAYS           0x00000002      /* Duplicate UI_SERVICE for consistency and compatibility */
  2587. #define SERVICE_UI_ALLOWED          0x00000010
  2588. #define UI_CURRENT_PROVIDER_FIRST   0x00000004
  2589. /* MSG_SERVICE_UI_READ_ONLY         0x00000008 - in MAPISPI.H */
  2591. /* GetProviderTable() */
  2592. /****** MAPI_UNICODE            ((ULONG) 0x80000000) above */
  2594. /* Values for PR_RESOURCE_FLAGS in message service table */
  2596. #define MAPI_IPROVIDERADMIN_METHODS(IPURE)                              
  2597.     MAPIMETHOD(GetLastError)                                            
  2598.         (THIS_  HRESULT                     hResult,                    
  2599.                 ULONG                       ulFlags,                    
  2600.                 LPMAPIERROR FAR *           lppMAPIError) IPURE;        
  2601.     MAPIMETHOD(GetProviderTable)                                        
  2602.         (THIS_  ULONG                       ulFlags,                    
  2603.                 LPMAPITABLE FAR *           lppTable) IPURE;            
  2604.     MAPIMETHOD(CreateProvider)                                          
  2605.         (THIS_  LPTSTR                      lpszProvider,               
  2606.                 ULONG                       cValues,                    
  2607.                 LPSPropValue                lpProps,                    
  2608.                 ULONG                       ulUIParam,                  
  2609.                 ULONG                       ulFlags,                    
  2610.                 MAPIUID FAR *               lpUID) IPURE;               
  2611.     MAPIMETHOD(DeleteProvider)                                          
  2612.         (THIS_  LPMAPIUID                   lpUID) IPURE;               
  2613.     MAPIMETHOD(OpenProfileSection)                                      
  2614.         (THIS_  LPMAPIUID                   lpUID,                      
  2615.                 LPCIID                      lpInterface,                
  2616.                 ULONG                       ulFlags,                    
  2617.                 LPPROFSECT FAR *            lppProfSect) IPURE;         
  2620. #undef       INTERFACE
  2621. #define      INTERFACE  IProviderAdmin
  2622. DECLARE_MAPI_INTERFACE_(IProviderAdmin, IUnknown)
  2623. {
  2624.     BEGIN_INTERFACE
  2625.     MAPI_IUNKNOWN_METHODS(PURE)
  2626.     MAPI_IPROVIDERADMIN_METHODS(PURE)
  2627. };
  2629. #ifndef WIN16
  2631. typedef HANDLE  HANDLE_16;
  2632. typedef WPARAM  WPARAM_16;
  2634. #define EXTERN_C_16
  2635. #define WINAPI_16
  2636. #define CALLBACK_16
  2637. #define EXPORT_16
  2638. #define LOADDS_16
  2639. #define HUGEP_16
  2640. #define APIENTRY_16    APIENTRY
  2642. #else   // ndef WIN16
  2644. typedef LPVOID HANDLE_16;
  2645. typedef DWORD  WPARAM_16;
  2647. #define EXTERN_C_16    EXTERN_C
  2648. #define WINAPI_16      WINAPI
  2649. #define CALLBACK_16    CALLBACK
  2650. #define EXPORT_16      __export
  2651. #define LOADDS_16      __loadds
  2652. #define HUGEP_16       HUGEP
  2653. #define APIENTRY_16    CALLBACK
  2655. #endif  // ndef WIN16
  2657. #ifndef WIN16
  2659. #define IF_WIN16(x)
  2660. #define IF_NOT_WIN16(x)     x
  2661. #define IF_WIN32(x)         x
  2663. #else   // ndef WIN16
  2665. #define IF_WIN16(x)         x
  2666. #define IF_NOT_WIN16(x) 
  2667. #define IF_WIN32(x)
  2669. #endif  // ndef WIN16
  2671. #ifdef  __cplusplus
  2672. }       /*  extern "C" */
  2673. #endif
  2675. #endif /* WABDEFS_H */