home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / vc98 / include / mapidbg.h < prev    next >
C/C++ Source or Header  |  1998-04-25  |  25KB  |  480 lines
  1. /*
  2.  *  M A P I D B G . H
  3.  *
  4.  *  Debugging support for MAPI service providers.
  5.  *  Support functions are implemented in MAPIDBG.C.
  6.  *
  7.  *  Copyright 1986-1996 Microsoft Corporation. All Rights Reserved.
  8.  */
  9.  
  10. #ifndef __MAPIDBG_H_
  11. #define __MAPIDBG_H_
  12.  
  13. #if defined (WIN32) && !defined (_WIN32)
  14. #define _WIN32
  15. #endif
  16.  
  17. /*
  18.  * Debugging Macros -------------------------------------------------------
  19.  *
  20.  *      IFDBG(x)        Results in the expression x if DEBUG is defined, or
  21.  *                      to nothing if DEBUG is not defined
  22.  *  
  23.  *      IFNDBG(x)       Results in the expression x if DEBUG is not defined,
  24.  *                      or to nothing if DEBUG is defined
  25.  *  
  26.  *      Unreferenced(a) Causes a to be referenced so that the compiler
  27.  *                      doesn't issue warnings about unused local variables
  28.  *                      which exist but are reserved for future use (eg
  29.  *                      ulFlags in many cases)
  30.  */
  31.  
  32. #if defined(DEBUG)
  33. #define IFDBG(x)            x
  34. #define IFNDBG(x)
  35. #else
  36. #define IFDBG(x)
  37. #define IFNDBG(x)           x
  38. #endif
  39.  
  40. #ifdef __cplusplus
  41. #define EXTERN_C_BEGIN      extern "C" {
  42. #define EXTERN_C_END        }
  43. #else
  44. #define EXTERN_C_BEGIN
  45. #define EXTERN_C_END
  46. #endif
  47.  
  48. #define dimensionof(a)      (sizeof(a)/sizeof(*(a)))
  49.  
  50. #define Unreferenced(a)     ((void)(a))
  51.  
  52. typedef long SCODE;
  53. typedef unsigned long ULONG;
  54. typedef unsigned long DWORD;
  55.  
  56. /*
  57.  *   Assert Macros ---------------------------------------------------------
  58.  *  
  59.  *      Assert(a)       Displays a message indicating the file and line number
  60.  *                      of this Assert() if a == 0.  OK'ing an assert traps
  61.  *                      into the debugger.
  62.  *  
  63.  *      AssertSz(a,sz)  Works like an Assert(), but displays the string sz
  64.  *                      along with the file and line number.
  65.  *  
  66.  *      Side asserts    A side assert works like an Assert(), but evaluates
  67.  *                      'a' even when asserts are not enabled.
  68.  *  
  69.  *      NF asserts      A NF (Non-Fatal) assert works like an Assert(), but
  70.  *                      continues instead of trapping into the debugger when
  71.  *                      OK'ed.
  72.  */
  73.  
  74. #if defined(DEBUG) || defined(ASSERTS_ENABLED)
  75. #define IFTRAP(x)           x
  76. #else
  77. #define IFTRAP(x)           0
  78. #endif
  79.  
  80. #define Trap()                                          IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,"Trap"))
  81. #define TrapSz(psz)                                     IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz))
  82. #define TrapSz1(psz,a1)                                 IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1))
  83. #define TrapSz2(psz,a1,a2)                              IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2))
  84. #define TrapSz3(psz,a1,a2,a3)                           IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3))
  85. #define TrapSz4(psz,a1,a2,a3,a4)                        IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4))
  86. #define TrapSz5(psz,a1,a2,a3,a4,a5)                     IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5))
  87. #define TrapSz6(psz,a1,a2,a3,a4,a5,a6)                  IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6))
  88. #define TrapSz7(psz,a1,a2,a3,a4,a5,a6,a7)               IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7))
  89. #define TrapSz8(psz,a1,a2,a3,a4,a5,a6,a7,a8)            IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8))
  90. #define TrapSz9(psz,a1,a2,a3,a4,a5,a6,a7,a8,a9)         IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8,a9))
  91.  
  92. #define Assert(t)                                       IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,"Assertion Failure: " #t),0))
  93. #define AssertSz(t,psz)                                 IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz),0))
  94. #define AssertSz1(t,psz,a1)                             IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz,a1),0))
  95. #define AssertSz2(t,psz,a1,a2)                          IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2),0))
  96. #define AssertSz3(t,psz,a1,a2,a3)                       IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3),0))
  97. #define AssertSz4(t,psz,a1,a2,a3,a4)                    IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4),0))
  98. #define AssertSz5(t,psz,a1,a2,a3,a4,a5)                 IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5),0))
  99. #define AssertSz6(t,psz,a1,a2,a3,a4,a5,a6)              IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6),0))
  100. #define AssertSz7(t,psz,a1,a2,a3,a4,a5,a6,a7)           IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7),0))
  101. #define AssertSz8(t,psz,a1,a2,a3,a4,a5,a6,a7,a8)        IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8),0))
  102. #define AssertSz9(t,psz,a1,a2,a3,a4,a5,a6,a7,a8,a9)     IFTRAP(((t) ? 0 : DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8,a9),0))
  103.  
  104. #define SideAssert(t)                                   ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,"Assertion Failure: " #t)),0)
  105. #define SideAssertSz(t,psz)                             ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz)),0)
  106. #define SideAssertSz1(t,psz,a1)                         ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1)),0)
  107. #define SideAssertSz2(t,psz,a1,a2)                      ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2)),0)
  108. #define SideAssertSz3(t,psz,a1,a2,a3)                   ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3)),0)
  109. #define SideAssertSz4(t,psz,a1,a2,a3,a4)                ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4)),0)
  110. #define SideAssertSz5(t,psz,a1,a2,a3,a4,a5)             ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5)),0)
  111. #define SideAssertSz6(t,psz,a1,a2,a3,a4,a5,a6)          ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6)),0)
  112. #define SideAssertSz7(t,psz,a1,a2,a3,a4,a5,a6,a7)       ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7)),0)
  113. #define SideAssertSz8(t,psz,a1,a2,a3,a4,a5,a6,a7,a8)    ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8)),0)
  114. #define SideAssertSz9(t,psz,a1,a2,a3,a4,a5,a6,a7,a8,a9) ((t) ? 0 : IFTRAP(DebugTrapFn(1,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8,a9)),0)
  115.  
  116. #define NFAssert(t)                                     IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,"Assertion Failure: " #t),0))
  117. #define NFAssertSz(t,psz)                               IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz),0))
  118. #define NFAssertSz1(t,psz,a1)                           IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz,a1),0))
  119. #define NFAssertSz2(t,psz,a1,a2)                        IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2),0))
  120. #define NFAssertSz3(t,psz,a1,a2,a3)                     IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3),0))
  121. #define NFAssertSz4(t,psz,a1,a2,a3,a4)                  IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4),0))
  122. #define NFAssertSz5(t,psz,a1,a2,a3,a4,a5)               IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5),0))
  123. #define NFAssertSz6(t,psz,a1,a2,a3,a4,a5,a6)            IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6),0))
  124. #define NFAssertSz7(t,psz,a1,a2,a3,a4,a5,a6,a7)         IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7),0))
  125. #define NFAssertSz8(t,psz,a1,a2,a3,a4,a5,a6,a7,a8)      IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8),0))
  126. #define NFAssertSz9(t,psz,a1,a2,a3,a4,a5,a6,a7,a8,a9)   IFTRAP(((t) ? 0 : DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8,a9),0))
  127.  
  128. #define NFSideAssert(t)                                 ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,"Assertion Failure: " #t)),0)
  129. #define NFSideAssertSz(t,psz)                           ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz)),0)
  130. #define NFSideAssertSz1(t,psz,a1)                       ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz,a1)),0)
  131. #define NFSideAssertSz2(t,psz,a1,a2)                    ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2)),0)
  132. #define NFSideAssertSz3(t,psz,a1,a2,a3)                 ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3)),0)
  133. #define NFSideAssertSz4(t,psz,a1,a2,a3,a4)              ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4)),0)
  134. #define NFSideAssertSz5(t,psz,a1,a2,a3,a4,a5)           ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5)),0)
  135. #define NFSideAssertSz6(t,psz,a1,a2,a3,a4,a5,a6)        ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6)),0)
  136. #define NFSideAssertSz7(t,psz,a1,a2,a3,a4,a5,a6,a7)     ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7)),0)
  137. #define NFSideAssertSz8(t,psz,a1,a2,a3,a4,a5,a6,a7,a8)  ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8)),0)
  138. #define NFSideAssertSz9(t,psz,a1,a2,a3,a4,a5,a6,a7,a8,a9)   ((t) ? 0 : IFTRAP(DebugTrapFn(0,__FILE__,__LINE__,psz,a1,a2,a3,a4,a5,a6,a7,a8,a9)),0)
  139.  
  140. /*
  141.  *   Trace Macros ------------------------------------------------------------
  142.  *  
  143.  *      DebugTrace          Use for arbitrary formatted output. It
  144.  *                          takes exactly the same arguments as the
  145.  *                          Windows wsprintf() function.
  146.  *      DebugTraceResult    Shorthand for error tracing with an
  147.  *                          HRESULT. Arguments are the name of the
  148.  *                          function (not quoted) and the HRESULT.
  149.  *      DebugTraceSc        Shorthand for error tracing with an
  150.  *                          SCODE. Arguments are the name of the
  151.  *                          function (not quoted) and the SCODE.
  152.  *      DebugTraceArg       Shorthand for invalid parameter
  153.  *                          tracing. Arguments are the name of the
  154.  *                          function (not quoted) and a quoted
  155.  *                          string describing the bad parameter.
  156.  */
  157.  
  158. #if defined(DEBUG) || defined(TRACES_ENABLED)
  159. #define IFTRACE(x)          x
  160. #define DebugTrace          DebugTraceFn
  161. #else
  162. #define IFTRACE(x)          0
  163. #define DebugTrace          1?0:DebugTraceFn
  164. #endif
  165.  
  166. #define DebugTraceResult(f,hr)                          IFTRACE(((hr) ? DebugTraceFn(#f " returns 0x%08lX %s\n", GetScode(hr), SzDecodeScode(GetScode(hr))) : 0))
  167. #define DebugTraceSc(f,sc)                              IFTRACE(((sc) ? DebugTraceFn(#f " returns 0x%08lX %s\n", sc, SzDecodeScode(sc)) : 0))
  168. #define DebugTraceArg(f,s)                              IFTRACE(DebugTraceFn(#f ": bad parameter: " s "\n"))
  169. #define DebugTraceLine()                                IFTRACE(DebugTraceFn("File %s, Line %i  \n",__FILE__,__LINE__))
  170. #define DebugTraceProblems(sz, rgprob)                  IFTRACE(DebugTraceProblemsFn(sz, rgprob))
  171.  
  172. #define TraceSz(psz)                                    IFTRACE(DebugTraceFn("~" psz))
  173. #define TraceSz1(psz,a1)                                IFTRACE(DebugTraceFn("~" psz,a1))
  174. #define TraceSz2(psz,a1,a2)                             IFTRACE(DebugTraceFn("~" psz,a1,a2))
  175. #define TraceSz3(psz,a1,a2,a3)                          IFTRACE(DebugTraceFn("~" psz,a1,a2,a3))
  176. #define TraceSz4(psz,a1,a2,a3,a4)                       IFTRACE(DebugTraceFn("~" psz,a1,a2,a3,a4))
  177. #define TraceSz5(psz,a1,a2,a3,a4,a5)                    IFTRACE(DebugTraceFn("~" psz,a1,a2,a3,a4,a5))
  178. #define TraceSz6(psz,a1,a2,a3,a4,a5,a6)                 IFTRACE(DebugTraceFn("~" psz,a1,a2,a3,a4,a5,a6))
  179. #define TraceSz7(psz,a1,a2,a3,a4,a5,a6,a7)              IFTRACE(DebugTraceFn("~" psz,a1,a2,a3,a4,a5,a6,a7))
  180. #define TraceSz8(psz,a1,a2,a3,a4,a5,a6,a7,a8)           IFTRACE(DebugTraceFn("~" psz,a1,a2,a3,a4,a5,a6,a7,a8))
  181. #define TraceSz9(psz,a1,a2,a3,a4,a5,a6,a7,a8,a9)        IFTRACE(DebugTraceFn("~" psz,a1,a2,a3,a4,a5,a6,a7,a8,a9))
  182.  
  183. /* Debugging Functions ---------------------------------------------------- */
  184.  
  185. EXTERN_C_BEGIN
  186.  
  187. #ifdef WIN16
  188. #define EXPORTDBG   __export
  189. #else
  190. #define EXPORTDBG
  191. #endif
  192.  
  193. int EXPORTDBG __cdecl       DebugTrapFn(int fFatal, char *pszFile, int iLine, char *pszFormat, ...);
  194. int EXPORTDBG __cdecl       DebugTraceFn(char *pszFormat, ...);
  195. void EXPORTDBG __cdecl      DebugTraceProblemsFn(char *sz, void *rgprob);
  196. char * EXPORTDBG __cdecl    SzDecodeScodeFn(SCODE sc);
  197. char * EXPORTDBG __cdecl    SzDecodeUlPropTypeFn(unsigned long ulPropType);
  198. char * EXPORTDBG __cdecl    SzDecodeUlPropTagFn(unsigned long ulPropTag);
  199. unsigned long EXPORTDBG __cdecl UlPropTagFromSzFn(char *psz);
  200. SCODE EXPORTDBG __cdecl     ScodeFromSzFn(char *psz);
  201. void * EXPORTDBG __cdecl    DBGMEM_EncapsulateFn(void * pmalloc, char *pszSubsys, int fCheckOften);
  202. void EXPORTDBG __cdecl      DBGMEM_ShutdownFn(void * pmalloc);
  203. void EXPORTDBG __cdecl      DBGMEM_CheckMemFn(void * pmalloc, int fReportOrphans);
  204. #if defined(_WIN32) && defined(_X86_)
  205. void EXPORTDBG __cdecl      DBGMEM_LeakHook(FARPROC pfn);
  206. void EXPORTDBG __cdecl      GetCallStack(DWORD *, int, int);
  207. #endif
  208. void EXPORTDBG __cdecl      DBGMEM_NoLeakDetectFn(void * pmalloc, void *pv);
  209. void EXPORTDBG __cdecl      DBGMEM_SetFailureAtFn(void * pmalloc, ULONG ulFailureAt);
  210. SCODE EXPORTDBG __cdecl     ScCheckScFn(SCODE, SCODE *, char *, char *, int);
  211. void * EXPORTDBG __cdecl    VMAlloc(ULONG);
  212. void * EXPORTDBG __cdecl    VMAllocEx(ULONG, ULONG);
  213. void * EXPORTDBG __cdecl    VMRealloc(void *, ULONG);
  214. void * EXPORTDBG __cdecl    VMReallocEx(void *, ULONG, ULONG);
  215. ULONG EXPORTDBG __cdecl     VMGetSize(void *);
  216. ULONG EXPORTDBG __cdecl     VMGetSizeEx(void *, ULONG);
  217. void EXPORTDBG __cdecl      VMFree(void *);
  218. void EXPORTDBG __cdecl      VMFreeEx(void *, ULONG);
  219.  
  220. EXTERN_C_END
  221.  
  222. /*
  223.  *  Debugging Macros -------------------------------------------------------
  224.  *  
  225.  *      SzDecodeScode           Returns the string name of an SCODE
  226.  *      SzDecodeUlPropTag       Returns the string name of a property
  227.  *                              tag
  228.  *      UlPropTagFromSz         Given a property tag's name, returns
  229.  *                              its value
  230.  *      ScodeFromSz             Given an SCODE's name, returns its
  231.  *                              value
  232.  *  
  233.  *      DBGMEM_Encapsulate      Given an IMalloc interface, adds heap-
  234.  *                              checking functionality and returns a
  235.  *                              wrapped interface
  236.  *      DBGMEM_Shutdown         Undoes DBGMEM_Encapsulate, and prints
  237.  *                              out information on any allocations made
  238.  *                              since the interface was encapsulated
  239.  *                              that have not yet been released.
  240.  *      DBGMEM_CheckMem         Checks all memory allocated on the heap,
  241.  *                              and optionally reports leaked blocks.
  242.  *      DBGMEM_NoLeakDetect     Prevents a block from appearing on the leak
  243.  *                              report.  Pass NULL for pv to inhibit leak
  244.  *                              reports at all from this heap.
  245.  */
  246.  
  247. #ifdef DEBUG
  248.  
  249. #define SzDecodeScode(_sc)              SzDecodeScodeFn(_sc)
  250. #define SzDecodeUlPropType(_ulPropType) SzDecodeUlPropTypeFn(_ulPropType)
  251. #define SzDecodeUlPropTag(_ulPropTag)   SzDecodeUlPropTagFn(_ulPropTag)
  252. #define UlPropTagFromSz(_sz)            UlPropTagFromSzFn(_sz)
  253. #define ScodeFromSz(_sz)                ScodeFromSzFn(_sz)
  254. #define DBGMEM_Encapsulate(pm, psz, f)  DBGMEM_EncapsulateFn(pm, psz, f)
  255. #define DBGMEM_Shutdown(pm)             DBGMEM_ShutdownFn(pm)
  256. #define DBGMEM_CheckMem(pm, f)          DBGMEM_CheckMemFn(pm, f)
  257. #define DBGMEM_NoLeakDetect(pm, pv)     DBGMEM_NoLeakDetectFn(pm, pv)
  258. #define DBGMEM_SetFailureAt(pm, ul)     DBGMEM_SetFailureAtFn(pm, ul)
  259.  
  260. #else
  261.  
  262. #define SzDecodeScode(_sc)              (0)
  263. #define SzDecodeUlPropType(_ulPropType) (0)
  264. #define SzDecodeUlPropTag(_ulPropTag)   (0)
  265. #define UlPropTagFromSz(_sz)            (0)
  266. #define ScodeFromSz(_sz)                (0)
  267.  
  268. #if defined(__cplusplus) && !defined(CINTERFACE)
  269. #define DBGMEM_Encapsulate(pmalloc, pszSubsys, fCheckOften) \
  270.     ((pmalloc)->AddRef(), (pmalloc))
  271. #define DBGMEM_Shutdown(pmalloc) \
  272.     ((pmalloc)->Release())
  273. #else
  274. #define DBGMEM_Encapsulate(pmalloc, pszSubsys, fCheckOften) \
  275.     ((pmalloc)->lpVtbl->AddRef(pmalloc), (pmalloc))
  276. #define DBGMEM_Shutdown(pmalloc) \
  277.     ((pmalloc)->lpVtbl->Release(pmalloc))
  278. #endif
  279. #define DBGMEM_CheckMem(pm, f)
  280. #define DBGMEM_NoLeakDetect(pm, pv)
  281. #define DBGMEM_SetFailureAt(pm, ul)
  282.  
  283. #endif
  284.  
  285. /*
  286.  *  SCODE maps -------------------------------------------------------------
  287.  *  
  288.  *      ScCheckSc       Given an SCODE and method name, verifies
  289.  *                      that the SCODE can legally be returned from
  290.  *                      thet method. Prints out a debug string if
  291.  *                      it cannot.
  292.  *      HrCheckHr       As ScCheckSc, for functions that return
  293.  *                      HRESULT.
  294.  */
  295.  
  296. #if defined(DEBUG) && !defined(DOS)
  297. #define ScCheckSc(sc,fn)                ScCheckScFn(sc,fn##_Scodes,#fn,__FILE__, __LINE__)
  298. #define HrCheckHr(hr,fn)                HrCheckSc(GetScode(hr),fn)
  299. #else
  300. #define ScCheckSc(sc,fn)                (sc)
  301. #define HrCheckHr(hr,fn)                (hr)
  302. #endif
  303.  
  304. #define HrCheckSc(sc,fn)                ResultFromScode(ScCheckSc(sc,fn))
  305.  
  306. #if defined(DEBUG) && !defined(DOS)
  307. extern SCODE Common_Scodes[];
  308. extern SCODE MAPILogon_Scodes[];
  309. extern SCODE MAPIAllocateBuffer_Scodes[];
  310. extern SCODE MAPIAllocateMore_Scodes[];
  311. extern SCODE MAPIFreeBuffer_Scodes[];
  312.  
  313. extern SCODE IUnknown_QueryInterface_Scodes[];
  314. extern SCODE IUnknown_AddRef_Scodes[];
  315. extern SCODE IUnknown_Release_Scodes[];
  316. extern SCODE IUnknown_GetLastError_Scodes[];
  317.  
  318. extern SCODE IMAPIProp_CopyTo_Scodes[];
  319. extern SCODE IMAPIProp_CopyProps_Scodes[];
  320. extern SCODE IMAPIProp_DeleteProps_Scodes[];
  321. extern SCODE IMAPIProp_GetIDsFromNames_Scodes[];
  322. extern SCODE IMAPIProp_GetLastError_Scodes[];
  323. extern SCODE IMAPIProp_GetNamesFromIDs_Scodes[];
  324. extern SCODE IMAPIProp_GetPropList_Scodes[];
  325. extern SCODE IMAPIProp_GetProps_Scodes[];
  326. extern SCODE IMAPIProp_OpenProperty_Scodes[];
  327. extern SCODE IMAPIProp_SetProps_Scodes[];
  328. extern SCODE IMAPIProp_SaveChanges_Scodes[];
  329.  
  330. extern SCODE IStream_Read_Scodes[];
  331. extern SCODE IStream_Write_Scodes[];
  332. extern SCODE IStream_Seek_Scodes[];
  333. extern SCODE IStream_SetSize_Scodes[];
  334. extern SCODE IStream_Tell_Scodes[];
  335. extern SCODE IStream_LockRegion_Scodes[];
  336. extern SCODE IStream_UnlockRegion_Scodes[];
  337. extern SCODE IStream_Clone_Scodes[];
  338. extern SCODE IStream_CopyTo_Scodes[];
  339. extern SCODE IStream_Revert_Scodes[];
  340. extern SCODE IStream_Stat_Scodes[];
  341. extern SCODE IStream_Commit_Scodes[];
  342.  
  343. extern SCODE IMAPITable_GetLastError_Scodes[];
  344. extern SCODE IMAPITable_Advise_Scodes[];
  345. extern SCODE IMAPITable_Unadvise_Scodes[];
  346. extern SCODE IMAPITable_GetStatus_Scodes[];
  347. extern SCODE IMAPITable_SetColumns_Scodes[];
  348. extern SCODE IMAPITable_QueryColumns_Scodes[];
  349. extern SCODE IMAPITable_GetRowCount_Scodes[];
  350. extern SCODE IMAPITable_SeekRow_Scodes[];
  351. extern SCODE IMAPITable_SeekRowApprox_Scodes[];
  352. extern SCODE IMAPITable_QueryPosition_Scodes[];
  353. extern SCODE IMAPITable_FindRow_Scodes[];
  354. extern SCODE IMAPITable_Restrict_Scodes[];
  355. extern SCODE IMAPITable_CreateBookmark_Scodes[];
  356. extern SCODE IMAPITable_FreeBookmark_Scodes[];
  357. extern SCODE IMAPITable_SortTable_Scodes[];
  358. extern SCODE IMAPITable_QuerySortOrder_Scodes[];
  359. extern SCODE IMAPITable_QueryRows_Scodes[];
  360. extern SCODE IMAPITable_Abort_Scodes[];
  361. extern SCODE IMAPITable_ExpandRow_Scodes[];
  362. extern SCODE IMAPITable_CollapseRow_Scodes[];
  363. extern SCODE IMAPITable_WaitForCompletion_Scodes[];
  364. extern SCODE IMAPITable_GetCollapseState_Scodes[];
  365. extern SCODE IMAPITable_SetCollapseState_Scodes[];
  366.  
  367. extern SCODE IMAPISession_LogOff_Scodes[];
  368. extern SCODE IMAPISession_Release_Scodes[];
  369. extern SCODE IMAPISession_GetLastError_Scodes[];
  370. extern SCODE IMAPISession_GetMsgStoresTable_Scodes[];
  371. extern SCODE IMAPISession_GetStatusTable_Scodes[];
  372. extern SCODE IMAPISession_OpenMsgStore_Scodes[];
  373. extern SCODE IMAPISession_OpenAddressBook_Scodes[];
  374. extern SCODE IMAPISession_OpenEntry_Scodes[];
  375. extern SCODE IMAPISession_OpenProfileSection_Scodes[];
  376. extern SCODE IMAPISession_Advise_Scodes[];
  377. extern SCODE IMAPISession_Unadvise_Scodes[];
  378. extern SCODE IMAPISession_CompareEntryIDs_Scodes[];
  379. extern SCODE IMAPISession_MessageOptions_Scodes[];
  380. extern SCODE IMAPISession_QueryDefaultMessageOpt_Scodes[];
  381. extern SCODE IMAPISession_EnumAdrTypes_Scodes[];
  382. extern SCODE IMAPISession_QueryIdentity_Scodes[];
  383. extern SCODE IMAPISession_OpenProfileSection_Scodes[];
  384. extern SCODE IMAPISession_GetStatusTable_Scodes[];
  385.  
  386. extern SCODE IMsgStore_Advise_Scodes[] ;
  387. extern SCODE IMsgStore_Unadvise_Scodes[] ;
  388. extern SCODE IMsgStore_CompareEntryIDs_Scodes[] ;
  389. extern SCODE IMsgStore_OpenEntry_Scodes[] ;
  390. extern SCODE IMsgStore_SetReceiveFolder_Scodes[];
  391. extern SCODE IMsgStore_GetReceiveFolder_Scodes[];
  392. extern SCODE IMsgStore_GetReceiveFolderTable_Scodes[];
  393. extern SCODE IMsgStore_StoreLogoff_Scodes[];
  394. extern SCODE IMsgStore_AbortSubmit_Scodes[];
  395. extern SCODE IMsgStore_GetOutgoingQueue_Scodes[] ;
  396. extern SCODE IMsgStore_SetLockState_Scodes[] ;
  397. extern SCODE IMsgStore_FinishedMsg_Scodes[] ;
  398. extern SCODE IMsgStore_NotifyNewMail_Scodes[];
  399.  
  400. extern SCODE IMAPIFolder_GetContentsTable_Scodes[];
  401. extern SCODE IMAPIFolder_GetHierarchyTable_Scodes[];
  402. extern SCODE IMAPIFolder_SaveContentsSort_Scodes[];
  403. extern SCODE IMAPIFolder_OpenEntry_Scodes[];
  404. extern SCODE IMAPIFolder_CreateMessage_Scodes[];
  405. extern SCODE IMAPIFolder_CopyMessages_Scodes[];
  406. extern SCODE IMAPIFolder_DeleteMessages_Scodes[];
  407. extern SCODE IMAPIFolder_CreateFolder_Scodes[];
  408. extern SCODE IMAPIFolder_CopyFolder_Scodes[];
  409. extern SCODE IMAPIFolder_DeleteFolder_Scodes[];
  410. extern SCODE IMAPIFolder_SetSearchCriteria_Scodes[];
  411. extern SCODE IMAPIFolder_GetSearchCriteria_Scodes[];
  412. extern SCODE IMAPIFolder_SetReadFlags_Scodes[];
  413. extern SCODE IMAPIFolder_GetMessageStatus_Scodes[];
  414. extern SCODE IMAPIFolder_SetMessageStatus_Scodes[];
  415. extern SCODE IMAPIFolder_EmptyFolder_Scodes[];
  416.  
  417. extern SCODE IMessage_SaveChanges_Scodes[];
  418. extern SCODE IMessage_GetAttachmentTable_Scodes[];
  419. extern SCODE IMessage_OpenAttach_Scodes[];
  420. extern SCODE IMessage_CreateAttach_Scodes[];
  421. extern SCODE IMessage_DeleteAttach_Scodes[];
  422. extern SCODE IMessage_GetRecipientTable_Scodes[];
  423. extern SCODE IMessage_ModifyRecipients_Scodes[];
  424. extern SCODE IMessage_SubmitMessage_Scodes[];
  425. extern SCODE IMessage_SetReadFlag_Scodes[];
  426.  
  427. extern SCODE IAttach_SaveChanges_Scodes[];
  428.  
  429. extern SCODE IAddrBook_OpenEntry_Scodes[];
  430. extern SCODE IAddrBook_CompareEntryIDs_Scodes[];
  431. extern SCODE IAddrBook_CreateOneOff_Scodes[];
  432. extern SCODE IAddrBook_ResolveName_Scodes[];
  433. extern SCODE IAddrBook_Address_Scodes[];
  434. extern SCODE IAddrBook_Details_Scodes[];
  435. extern SCODE IAddrBook_RecipOptions_Scodes[];
  436. extern SCODE IAddrBook_QueryDefaultRecipOpt_Scodes[];
  437. extern SCODE IAddrBook_Address_Scodes[];
  438. extern SCODE IAddrBook_ButtonPress_Scodes[];
  439.  
  440. extern SCODE IABContainer_GetContentsTable_Scodes[];
  441. extern SCODE IABContainer_GetHierarchyTable_Scodes[];
  442.  
  443. extern SCODE INotifObj_ChangeEvMask_Scodes[];
  444.  
  445. extern SCODE IMAPIStatus_ChangePassword_Scodes[];
  446. extern SCODE IMAPIStatus_FlushQueues_Scodes[];
  447. extern SCODE IMAPIStatus_SettingsDialog_Scodes[];
  448. extern SCODE IMAPIStatus_ValidateState_Scodes[];
  449.  
  450. extern SCODE IMSProvider_Logon_Scodes[];
  451. extern SCODE IMSProvider_Deinit_Scodes[];
  452. extern SCODE IMSProvider_Init_Scodes[];
  453. extern SCODE IMSProvider_SpoolerLogon_Scodes[];
  454. extern SCODE IMSProvider_Shutdown_Scodes[];
  455.  
  456. extern SCODE SMAPI_MAPILogon_Scodes[];
  457. extern SCODE SMAPI_MAPILogoff_Scodes[];
  458. extern SCODE SMAPI_MAPIFreeBuffer_Scodes[];
  459. extern SCODE SMAPI_MAPISendMail_Scodes[];
  460. extern SCODE SMAPI_MAPISendDocuments_Scodes[];
  461. extern SCODE SMAPI_MAPIFindNext_Scodes[];
  462. extern SCODE SMAPI_MAPIReadMail_Scodes[];
  463. extern SCODE SMAPI_MAPISaveMail_Scodes[];
  464. extern SCODE SMAPI_MAPIDeleteMail_Scodes[];
  465. extern SCODE SMAPI_MAPIAddress_Scodes[];
  466. extern SCODE SMAPI_MAPIResolveName_Scodes[];
  467. extern SCODE SMAPI_MAPIDetails_Scodes[];
  468.  
  469. extern SCODE IMSLogon_OpenEntry_Scodes[];
  470. extern SCODE IMSLogon_OpenStatusEntry_Scodes[];
  471. extern SCODE IMSLogon_CompareEntryIDs_Scodes[];
  472. extern SCODE IMSLogon_Advise_Scodes[];
  473. extern SCODE IMSLogon_Unadvise_Scodes[];
  474. extern SCODE IMSLogon_Logoff_Scodes[];
  475. #endif
  476.  
  477. /* ------------------------------------------------------------------------ */
  478.  
  479. #endif
  480.