IABLogon::OpenStatusEntry

The IABLogon::OpenStatusEntry method opens the provider's status object.

Quick Info

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.