CALLERRELEASE

适用于:Outlook 2013 | Outlook 2016

定义一个回调函数,该回调函数可在释放表视图时释放表数据对象。

属性
标头文件:
Mapiutil.h
由实现的已定义函数:
客户端应用程序和服务提供商
由调用的已定义函数:
MAPI
void CALLERRELEASE(
  ULONG_PTR ulCallerData,
  LPTABLEDATA lpTblData,
  LPMAPITABLE lpVue
);

参数

ulCallerData

[in]由 MAPI 使用表视图保存的调用方数据,并传递给基于 CALLERRELEASE 的回调函数。 数据提供有关要发布的表视图的上下文。

lpTblData

[in]指向 ITableData:IUnknown 接口的指针,该接口位于要释放的表视图的基础的表数据对象。

lpVue

[in]指向正在发布的表视图的 IMAPITable :IUnknown 接口的指针。 这是创建要发布的对象的 ITableData::HrGetView 方法的 lppMAPITable 参数中返回的表对象的接口。

返回值

None

备注

已填充表数据对象的客户端应用程序或服务提供程序可以调用 ITableData::HrGetView 来创建表的只读排序视图。 对 HrGetView 的调用传递指向基于 CALLERRELEASE 的回调函数的指针,以及要随表视图一起保存的上下文。 当表视图的引用计数返回零且视图被释放时, IMAPITable 实现将调用回调函数,并在 ulCallerData 参数中传递上下文。

基于 CALLERRELEASE 的回调函数的常见用途是释放基础表数据对象,无需在后续处理期间跟踪该对象。