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.