IABContainer::OpenEntry


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

IABContainer::OpenEntry
HRESULT OpenEntry(
    ULONG         cbEntryID,
    LPENTRYID     lpEntryID,
    LPCIID        lpInterface,
    ULONG         ulFlags,
    ULONG FAR     *lpulObjType,
    LPUNKNOWN FAR *lppUnk
);
Opens a child container object contained in the open container and returns a pointer to the object to provide further access.
Returns S_OK if successful.

cbEntryID
Count of bytes in the entry identifier pointed to by the lpEntryID parameter.
lpEntryID
Address of the entry identifier of the object to open. If lpEntryID is set to NULL, the top-level container in the container's hierarchy is opened.
lpInterface
Address of the interface identifier (IID) representing the interface to be used to access the object. Passing NULL results in the identifier for the object's standard interface being returned. For messages, the standard interface is IMessage; for folders, it is IMAPIFolder. The standard interfaces for address book objects are IDistList for a distribution list and IMailUser for a messaging user.
ulFlags
Bitmask of flags that control how the object is opened. The following flags can be used:

MAPI_BEST_ACCESS Requests that the object be opened with the maximum network permissions allowed for the user and the maximum client application access. For example, if the client has read/write access, the object should be opened with read/write access; if the client has read-only access, the object should be opened with read-only access.

MAPI_DEFERRED_ERRORS Not supported by Internet Explorer Address Book at this time.

MAPI_MODIFY Requests read/write access. By default, objects are opened with read-only access, and clients should not work on the assumption that read/write access has been granted.

lpulObjType
Address of the opened object's type.
lppUnk
Address of a pointer to the interface implementation to use to access the open object.

Back to top

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

MAPI_BEST_ACCESS	Requests that the object be opened with the maximum network permissions allowed for the user and the maximum client application access. For example, if the client has read/write access, the object should be opened with read/write access; if the client has read-only access, the object should be opened with read-only access.
MAPI_DEFERRED_ERRORS	Not supported by Internet Explorer Address Book at this time.
MAPI_MODIFY	Requests read/write access. By default, objects are opened with read-only access, and clients should not work on the assumption that read/write access has been granted.