IMAPIOffline::GetCapabilities

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Gets the conditions for which callbacks are supported by an offline object.

HRESULT GetCapabilities( 
    ULONG *pulCapabilities 
);

Parameters

  • pulCapablities
    [out] A bitmask of the following capability flags:

    • MAPIOFFLINE_CAPABILITY_OFFLINE
      The offline object is capable of providing offline notifications.

    • MAPIOFFLINE_CAPABILITY_ONLINE
      The offline object is capable of providing online notifications.

Remarks

Upon opening an offline object using HrOpenOfflineObj, a client can query on IMAPIOfflineMgr to obtain a pointer to an IMAPIOffline interface, and call IMAPIOffline::GetCapabilities to find out the callbacks supported by the object. The client can then choose to set up callbacks by using IMAPIOfflineMgr.

Note that, depending on the mail server for an offline object, an object that supports callbacks for going online does not necessarily support callbacks for going offline.

Also note that, while an offline object may support callbacks for changes other than online/offline, the Offline State API supports only online/offline changes, and clients must check for only such capabilities.

See Also

Reference

IMAPIOffline::GetCurrentState

IMAPIOffline::SetCurrentState

IMAPIOfflineMgr : IMAPIOffline

Concepts

MAPI Constants

HrOpenOfflineObj