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。