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

源码开发语言/平台
当前位置：首页 > 源码/资料 > Windows编程 > 界面编程 > 对话框与窗口 > 查看源码
MAPIDefS.h
资源名称：Xtreme.ToolkitPro.v12.0.0.rar　[点击查看]
上传用户：szled88
上传日期：2015-04-09
资源大小：43957k
文件大小：96k
源码类别：

对话框与窗口

开发平台：

Visual C++

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