MAPIDBG.INI [Spooler] Section

The entries in this section control debugging features in the MAPI spooler.

AlwaysRebuild = 0|1

If this entry is set to 1, the MAPI spooler rebuilds its merged outgoing queue on every outgoing queue notification. If it is 0, the queue is only rebuilt when opening a message store for the first time. The default value is 0 — rebuild the outgoing queue rarely.

AssertSessionLeaks = 0|1

If this entry is set to 1, the MAPI spooler asserts if it finds a reference count of greater than 1 when freeing memory for one of its IMAPISession objects. The default value is 0 — no assert for leaked spooler-side sessions.

LowPrioritySpooling = 0|1

If this entry is set to 1, the MAPI spooler gives its main thread below-normal base priority by calling the Win32 function SetThreadPriority and setting the THREAD_PRIORITY_BELOW_NORMAL value. If it is 0, the MAPI spooler runs at normal priority. The MAPI spooler continues to adjust its priority when flushing and performing other foreground operations regardless of this entry's value. The default value is 1 — the MAPI spooler runs at below-normal priority.

NonPersistanceTimeout = seconds

This entry controls the length of time the MAPI spooler waits before exiting. The MAPI spooler exits after the last client session has logged off, but not immediately. The default value is 20 seconds.

SafeMode = 0|1

If this entry is set to 1, then during its startup the MAPI spooler aborts submission on all messages in the outgoing queue and restarts the submission process from scratch. Submission is not aborted during subsequent rebuilds of the outgoing queue. If it is 0, the submission state is left intact. The default value is 0 — do not abort submission when the outgoing queue changes.

TraceHeartbeat = 0|1

If this entry or TraceEverything is set to 1, the MAPI spooler generates debug trace output during its normal idle time processing. The default value is 0 — no traces are generated for normal idle processing.

TraceHooks = 0|1

If this entry or TraceEverything is set to 1, the MAPI spooler generates debug trace output for normal operations involving MAPI spooler hook providers. The default value is 0 — no trace output is generated for normal hook operation.

TraceUploads = 0|1

If this entry or TraceEverything is set to 1, the MAPI spooler generates debug trace output for normal message transmission steps through message transports. The default value is 0 — no trace output is generated for normal message transmission.

TraceDownloads = 0|1

If this entry or TraceEverything is set to 1, the MAPI spooler generates debug trace output for normal message download steps from transport providers. The default value is 0 — no trace output is generated for normal downloading of messages.

TraceOutgoingQueues = 0|1

If this entry or TraceEverything is set to 1, the MAPI spooler generates debug trace output for normal notifications and other operations on the merged outgoing queue. The MAPI spooler maintains a merged outgoing queue that combines messages from outgoing queues of all open message stores that support message submission. The default value is 0 — no trace output is generated for normal outgoing queue processing.

TracePreprocessors = 0|1

If this entry or TraceEverything is set to 1, the MAPI spooler generates debug trace output when calling preprocessors. The default value is 0 — no trace output is generated for normal preprocessing operations.

TraceService = 0|1

If this entry or TraceEverything is set to 1, the MAPI spooler generates debug trace output when queuing, dequeueing, and processing service requests on behalf of MAPI and transport providers. The default value is 0 — no trace output is generated for normal service queue processing.

TraceVerbose = 0|1

If this entry or TraceEverything is set to 1, the MAPI spooler generates debug trace output in all categories for events that would otherwise be considered too frequent or insignificant to warrant trace output. The default value is 0 — the MAPI spooler does not generate trace output.

TraceYields = 0|1

If this entry or TraceEverything is set to 1, the MAPI spooler generates debug trace output when explicitly yielding the CPU to other processes, either on its own behalf or on behalf of a transport provider. The default value is 0 — no trace output is generated when yielding.

TraceEverything = 0|1

If this entry is set to 1, all the trace output requested by TraceHeartbeat, TraceHooks, TraceUploads, TraceDownloads, TraceOutgoingQueues, TracePreprocessors, TraceService, TraceVerbose, and TraceYields is generated, and the values of those entries are ignored. You cannot selectively turn off trace categories when TraceEverything is 1. The default value is 0 — entries for the individual categories control trace output.