IMAPISession::OpenMsgStore

Article
08/28/2006

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