Edit

MAPICrashRecovery

  • Article

Applies to: Outlook 2013 | Outlook 2016

The MAPICrashRecovery function checks the state of the Personal Folders file (PST) or Offline Folders file (OST) shared memory. If the memory is in a consistent state, the MAPICrashRecovery function moves the data to disk and prevents further read or write access until the process is terminated.

Quick info

Property Value
Exported by:
olmapi32.dll
Called by:
Client
Implemented by:
Outlook 
void MAPICrashRecovery(ULONG ulFlags);

Parameters

ulFlags

[in] Flags used to control how the MAPI crash recovery is performed. The following flags can be set:

  • MAPICRASH_RECOVER: If the PSTs or OSTs are in a consistent state, move the data to disk and lock the PSTs or OSTs to prevent read or write access.

  • MAPICRASH_CONTINUE: Unlock the PSTs or OSTs for debugging. After a successful call to MAPICrashRecovery with the MAPICRASH_RECOVER flag, call MAPICrashRecovery with the MAPICRASH_CONTINUE flag to allow debugging to continue.

  • MAPICRASH_SYSTEM_SHUTDOWN: If the PSTs or OSTs are in a consistent state, move the data to disk and lock the PSTs or OSTs to prevent read or write access. The PSTs or OSTs cannot be unlocked using MAPICRASH_CONTINUE. Must be used in combination with MAPICRASH_RECOVER.

Remarks

The upper byte (0xFF000000) is reserved for provider specific crash recovery flags.

Call MAPICrashRecovery with the MAPICRASH_RECOVER and MAPICRASH_SYSTEM_SHUTDOWN flags in response to the WM_ENDSESSION message.

See also