Contents Index Topic Contents
	Previous Topic: IAddrBook::NewEntry Next Topic: IAddrBook::OpenProperty

IAddrBook::OpenEntry

HRESULT OpenEntry(
    ULONG cbEntryID,
    LPENTRYID lpEntryID,
    LPCIID lpInterface,
    ULONG ulFlags,
    ULONG FAR * lpulObjType,
    LPUNKNOWN FAR * lppUnk
);

Opens a container or mail user object and returns a pointer to the object.

• Returns one of the following values:

  S_OK	The entry was successfully opened.
  MAPI_E_NO_ACCESS	An attempt was made to open an entry for which the user has insufficient permissions.
  MAPI_E_NOT_FOUND	The entry represented by lpEntryID does not exist.
  MAPI_E_UNKNOWN_ENTRYID	The entry identifier specified in lpEntryID is not recognized. This value is typically returned if the address book provider responsible for the corresponding entry is not open.

cbEntryID

Size, in bytes, for the entry identifier to open.

lpEntryID

Entry identifier of the object to open (NULL for the root address book container).

lpInterface

Address of the interface identifier (IID) for the object to open. Pass NULL to specify the standard interface for the object.

ulFlags

Bitmask containing the object access flags. Default is read access only. The following flags can be used for modifications:

MAPI_BEST_ACCESS	Specifies to open with best available access rights.
MAPI_MODIFY	Requests read/write access.
MAPI_DEFERRED_ERRORS	Currently not supported by Internet Explorer Address Book.

lpulObjType

Returned object type.

lppUnk

Returned object pointer.

Back to top

---

 Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.