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.