IABContainer::OpenEntryIABContainer::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.

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

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