Contents Index Topic Contents
	Previous Topic: IDistList::GetSearchCriteria Next Topic: IDistList::OpenProperty

IDistList::OpenEntry

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

Opens an entry contained in the distribution list and returns a pointer to the object to provide further access.

• 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

Value that represents the number of bytes contained in the entry identifier to open.

lpEntryID

Address of an entry identifier of the object to open.

lpInterface

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

ulFlags

Bitmask containing object access flags. The 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

Address of the object type of the opened entry.

lppUnk

Returned object pointer to the opened entry.

Back to top

---

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