IMAPISession::OpenMsgStore

4/8/2010

The OpenMsgStore method opens a message store and returns a reference to the IMsgStore object for further access.

Syntax

HRESULT OpenMsgStore (
  ULONG ulUIParam,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPCIID lpInterface,
  ULONG ulFlags,
  LPMDB FAR * lppMDB
);

Parameters

  • ulUIParam
    [in] Ignored.
  • cbEntryID
    [in] Count of bytes in the entry identifier specified by lpEntryID.
  • lpEntryID
    [in] Reference to the entry identifier of the message store that is to be opened.
  • lpInterface
    [in] Ignored.
  • ulFlags
    [in] Ignored.
  • lppMDB
    [out] Reference to the message store object, implemented on IMsgStore.

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

  • S_OK
    Indicates success.
  • MAPI_E_NOT_FOUND
    The message store indicated by lpEntryID does not exist.

Remarks

The access level for message stores is always read/write.

Requirements

Header mapix.h
Library cemapi.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

IMAPISession

Other Resources

Messaging