IAddrBook::OpenEntry Method

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

Syntax

HRESULT OpenEntry(
    ULONG cbEntryID,
    ENTRYID *lpEntryID,
    CIID *lpInterface,
    ULONG ulFlags,
    ULONG *lpulObjType,
    LPUNKNOWN *lppUnk
);

Parameters

cbEntryID

ULONG

Value of type ULONG that specifies the size of the entry identifier to open.

lpEntryID

ENTRYID

Pointer to a variable of type ENTRYID that specifies the entry identifier of the object to open (NULL for the root WAB container).

lpInterface

CIID

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

ulFlags

ULONG

Value of type ULONG that specifies the bitmask containing object access flags.

0

Default. Read access only.

MAPI_BEST_ACCESS

Opens with the best available access rights.

MAPI_MODIFY

Requests read/write access.

lpulObjType

ULONG

Pointer to a variable of type ULONG that receives the returned object type.

lppUnk

LPUNKNOWN

Address of a pointer to a variable of type IUnknown that receives the returned object.

Return Value

HRESULT

The method can return one of the following values.

Return code	Description
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.

 

Requirements

Minimum supported client	Windows 2000 Professional
Minimum supported server	Windows 2000 Server
Product	Internet Explorer 4.0
Header	Wabiab.h
DLL	Wab32.dll

See Also

IAddrBook

 

 

Send comments about this topic to Microsoft

Build date: 6/30/2010