ITableData::HrGetView
适用于:Outlook 2013 | Outlook 2016
创建表视图,返回指向 IMAPITable 实现的指针。
HRESULT HrGetView(
LPSSortOrderSet lpSSortOrderSet,
CALLERRELEASE FAR * lpfCallerRelease,
ULONG_PTR ulCallerData,
LPMAPITABLE FAR * lppMAPITable
);
参数
lpSSortOrderSet
[in]指向描述表视图排序顺序的排序顺序结构的指针。 如果在 lpSSortOrderSet 参数中传递 NULL,则不会对视图进行排序。
lpfCallerRelease
[in]指向基于 MAPI 在释放视图时调用的 CALLERRELEASE 原型的回调函数的指针。 如果在 lpfCallerRelease 参数中传递 NULL,则发布视图时不会调用任何函数。
ulCallerData
[in]必须使用新视图保存并传递给 lpfCallerRelease 指向的回调函数的数据。
lppMAPITable
[out]指向新创建的视图的指针的指针。
返回值
S_OK
已成功创建视图。
备注
ITableData::HrGetView 方法创建表中数据的只读视图,按 lpSSortOrderSet 参数指向的顺序排序。 光标位于视图中第一行的开头。 返回用于访问视图的 IMAPITable 接口实现。
服务提供商在需要向客户端授予对表的访问权限时调用 HrGetView 。 HrGetView 创建视图并返回 IMAPITable 指针。 服务提供商反过来将指针传递到客户端。 当客户端使用完表并调用其 IUnknown::Release 方法时, HrGetView 将调用 lpfCallerRelease 参数指向的回调函数。
如果服务提供程序需要将具有自定义列集或限制的视图返回到客户端,则提供程序可以在允许客户端访问之前调用该视图的 IMAPITable::SetColumns 和 IMAPITable::Restrict 方法。