HrOpenOfflineObj

适用于:Outlook 2013 | Outlook 2016

打开基于给定配置文件的脱机对象。

快速信息

属性
导出者:
msmapi32.dll
调用者:
客户端
实现者:
Outlook
typedef HRESULT (STDMETHODCALLTYPE HROPENOFFLINEOBJ)( 
      ULONG ulReserved, 
      LPCWSTR pwszProfileNameIn, 
      const GUID* pGUID, 
      const GUID* pReserved, 
      IMAPIOfflineMgr** ppOfflineObj); 

参数

ulReserved

[in]不使用此参数。 它必须为 0。

pwszProfileNameIn

[in]脱机对象所针对的配置文件的名称。 它必须用 Unicode 表示。

pGUID

[in]指向 GUID 的指针,该 GUID 可用于从其他脱机对象中唯一标识此对象。 它必须 GUID_GlobalState

保存

[in]不使用此参数。 它必须为 null

ppOfflineObj

[out]指向请求的脱机对象的指针。 调用方可以使用此指针访问 IMAPIOfflineMgr :IMAPIOffline 接口,以查找此对象支持的回调并为其设置回调。

返回值

S_OK

  • 函数调用成功。

MAPI_E_NOT_FOUND

  • 函数调用失败。

备注

这是当客户端希望收到给定配置文件的任何连接状态更改的通知时,客户端进行的第一次调用。 调用 HrOpenOfflineObj 时,客户端获取支持 IMAPIOfflineMgr 的脱机对象。 客户端可以使用 IMAPIOffline::GetCapabilities) (对象支持的回调类型检查,然后使用 IMAPIOfflineMgr::Advise) (为其设置回调。

使用 GetProcAddress 在 msmapi32.dll 中查找此函数的地址时,请指定 HrOpenOfflineObj@20 作为过程名称。

HrOpenOfflineObj 仅适用于在 Outlook 进程中运行的 MAPI 提供程序、COM 加载项和 Exchange 客户端扩展的客户端。 否则, HrOpenOfflineObj 返回 MAPI_E_NOT_FOUND

另请参阅

IMAPIOffline : IUnknown

IMAPIOfflineMgr : IMAPIOffline

关于脱机状态 API

MAPI 常量