IABLogon::OpenStatusEntry

Last modified: July 23, 2011

Applies to: Outlook

Opens the provider's status object.

HRESULT OpenStatusEntry(
  LPCIID lpInterface,
  ULONG ulFlags,
  ULONG FAR * lpulObjType,
  LPMAPISTATUS FAR * lppEntry
);

lpInterface

[in] A pointer to the interface identifier (IID) that represents the interface that must be used to access the status object. Passing NULL returns the object's standard interface, IMAPIStatus : IMAPIProp.

ulFlags

[in] A bitmask of flags that controls how the status object is opened. The following flag can be set:

MAPI_MODIFY

Requests read/write permission. By default, objects are opened with read-only access, and callers should not assume that read/write permission has been granted.

lpulObjType

[out] A pointer to the type of the opened object.

lppEntry

[out] A pointer to a pointer to the opened object.

S_OK

The call succeeded and the status object has been opened.

Address book providers implement the 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 Status Object Implementation.

Show: