Share via


IMAPISession::OpenMsgStore

Send Feedback

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 Values

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_NO_ACCESS
    An attempt was made to access a message store for which the user has insufficient permissions.
  • MAPI_E_NOT_FOUND
    The message store indicated by lpEntryID does not exist.
  • MAPI_E_UNKNOWN_CPID
    The server is not configured to support the client code page.
  • MAPI_E_UNKNOWN_LCID
    The server is not configured to support the client locale information.
  • MAPI_W_ERRORS_RETURNED
    The call succeeded, but the message store provider has error information available. When this warning is returned, the call should be handled as successful.

Remarks

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

Requirements

Pocket PC: Pocket PC 2002 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: mapix.h
Library: cemapi.lib

See Also

IMAPISession | Messaging

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.