IABLogon::OpenStatusEntry
The IABLogon::OpenStatusEntry
method opens the provider s status object.
Quick Info
See IABLogon
: IUnknown.
HRESULT OpenStatusEntry(
|
LPCIID lpInterface, |
|
|
ULONG ulFlags, |
|
|
ULONG FAR * lpulObjType, |
|
|
LPMAPISTATUS FAR * lppMAPIStatus |
|
|
) |
|
Parameters
lpInterface
[in] Pointer
to the interface identifier (IID) representing the interface to be used to
access the status object. Passing NULL results in the object s standard interface
being returned, which is IMAPIStatus.
ulFlags
[in] Bitmask
of flags that controls how the status object is opened. The following flag can
be set:
MAPI_MODIFY
Requests
read/write access. By default, objects are opened with read-only access, and
callers should not work on the assumption that read/write access has been
granted.
lpulObjType
[out] Pointer
to the type of the opened object.
lppEntry
[out] Pointer
to a pointer to the opened object.
Return Value
S_OK
The call
succeeded and the status object has been opened.
Remarks
Address book
providers implement the IABLogon::OpenStatusEntry method to grant access
to their status object. All address book providers are required to implement a
status object that supports at a minimum the IMAPIStatus::ValidateState
method. For more information, see Implementing a Status Object.
See Also