MAPICrashRecovery

  • [アーティクル]

Applies to: Office 2010 | Outlook 2010 | Visual Studio

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.

Quick Info

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

Concepts

About the MAPI Crash Recovery API

How to: Use the MAPI Crash Recovery API