MAPIDBG.INI [General] Section

The entries in this section control debugging features common to all MAPI components.

AssertBadBlocks = 0|1

If this entry is set to 1, the MAPIAllocateMore and MAPIFreeBuffer functions assert when passed an invalid memory address. If it is set to 0, they fail without asserting. This is useful for detecting bugs such as freeing uninitialized pointers and freeing blocks more than once. The default value is 1 — asserts are generated.

AssertLeaks = 0|1

If this entry is set to 1, MAPI asserts if any service provider DLL, IMAPISession interface, or IProfAdmin interface is not released before MAPI is shut down. The default value is 0 — asserts are not generated.

DebugTrace = 0|1

This entry controls trace output from several of the macros defined in MAPIDBG.H, including DebugTrace and the TraceSz and Assert group of macros. If this entry is set to 1, traces are written to the debug port using the Win32 function OutputDebugString, and can be captured using a debugger or a monitoring utility such as DBWIN.EXE (for Win16) or DEB.EXE (for Win32). If this entry is set to 0, no traces are written. The default value is 1 — traces are enabled.

EventLog = 0|1

On Windows NT only , if this entry is set to 1, all debug traces are written to the application event log instead of to the debug port. This is useful when debugging an NT service that uses MAPI. The default value is 0 — traces are written to the debug port, not the event log.

MemoryFillRandom = 0|1

This entry is obsolete. Use the FillMemory entry in the [Memory Management] section.

RetainDLLs = 0|1

If this entry is set to 1, MAPI does not call the Win32 function FreeLibrary to release provider DLLs although it does remove them from its internal data structures. This can occasionally be useful when pursuing bugs in provider startup and shutdown behavior. The default value is 0 — provider DLLs are freed.

TrapOnSameThread = 0|1

On Win32, if this entry is set to 1, the message dialog boxes generated by the Trap and Assert group of macros are created on the calling thread. If it is set to 0, the message box is generated on a separate thread to prevent reentering the message loop on the calling thread. The default value is 0 — message dialog boxes are generated on a separate thread.

VerboseTNEF = 0|1

If this entry is set to 1, the MAPI TNEF facility generates debug trace output for routine operations. If it is set to 0, TNEF generates traces only when errors occur. The default value is 1 — TNEF traces are verbose.

VirtualMemory = 0|1|4

This entry is obsolete. Use the VirtualMemory entry in the [Memory Management] section.