MAPICrashRecovery
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.