Expand Minimize

MAPICrashRecovery

Last modified: July 23, 2011

Applies to: Outlook

In this article
Quick Info
Parameters
Remarks

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.

Exported by:

olmapi32.dll

Called by:

Client

Implemented by:

Outlook

void MAPICrashRecovery(ULONG ulFlags);

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.

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.

Show:
© 2014 Microsoft