Partager via

IABLogon::OpenStatusEntry

  • Article

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Opens the provider's status object.

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

Parameters

  • 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.

Return Value

  • S_OK
    The call succeeded and the status object has been opened.

Remarks

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.

See Also

Reference

IMAPIStatus : IMAPIProp

IMAPIStatus::SettingsDialog

IMAPIStatus::ValidateState

IABLogon : IUnknown