Input parameter. Specifies the distinguished name of the mailbox your service is attempting to access.
ulFlags
Input parameter. Defined values that control what gets opened. Use the bitwise OR operator (|) to enable multiple operations:
OPENSTORE _HOME_LOGON
Opens the home logon of the user's information store. Should be used when a separate logon to the user's information store is required. For example, if your application tracks the Read status of messages in a public folder on a per-user basis, it must logon to the user's mailbox in addition to the public folder to mark certain items as Read.
OPENSTORE _OVERRIDE_HOME_MDB
Ignores the current home information store for the user. Use OPENSTORE_OVERRIDE_HOME_MDB to implement methods that move a mailbox or copy a mailbox to a server other than the home server of the user. You cannot create multiple mailboxes on different servers for a single user, unless you specify this flag.
OPENSTORE_PUBLIC
Opens the public information store.
OPENSTORE _TAKE_OWNERSHIP
Opens the information store as the owner of the store, using the identity of the owner of the store. Posts a security event to the event log.
OPENSTORE _USE_ADMIN_PRIVILEGE
Opens the information store of another user, if you have administration rights on the other information store. Allows your application to own the information store while it's running, but does not log you on the mailbox under the identity of the owner of the mailbox. Posts a security event to the event log. OPENSTORE_USE_ADMIN_PRIVILEGE is normally used in conjunction with OPENSTORE_TAKE_OWNERSHIP.
lpcbEntryID
Output parameter. The number of bytes returned in the entry identifier that is pointed to by lppEntryID.
lppEntryID
Output parameter. A pointer to the entry identifier.
Note If a user can use your application to browse their own folders, you must set the MDB_TEMPORARY and MDB_NO_MAIL bits in the ulFlags parameter to the MAPI IMAPISession::OpenMsgStore method.
This method creates and returns an entry identifier that can be used to access a server mailbox using the MAPI IMAPISession::OpenMsgStore method. For more information, see the MAPI Programmer's Reference.
In addition, this method formats the entry identifier and does not access the information store or require any resources on the server. As a result, this method call is a relatively inexpensive operation. Your application should free the entry identifier after it has finished using it.