CALLERRELEASE

Applies to: Outlook 2013 | Outlook 2016

Defines a callback function that can release a table data object when a table view is being released.

Property	Value
Header file:	Mapiutil.h
Defined function implemented by:	Client applications and service providers
Defined function called by:	MAPI

void CALLERRELEASE(
  ULONG_PTR ulCallerData,
  LPTABLEDATA lpTblData,
  LPMAPITABLE lpVue
);

Parameters

ulCallerData

[in] Caller data saved by MAPI with the table view and passed to the CALLERRELEASE based callback function. The data provides context about the table view being released.

lpTblData

[in] Pointer to the ITableData : IUnknown interface for the table data object underlying the table view being released.

lpVue

[in] Pointer to the IMAPITable : IUnknown interface for the table view being released. This is an interface for the table object returned in the lppMAPITable parameter of the ITableData::HrGetView method that created the object to release.

Return value

None

Remarks

A client application or service provider that has populated a table data object can call ITableData::HrGetView to create a read-only, sorted view of the table. The call to HrGetView passes a pointer to a CALLERRELEASE based callback function and also a context to be saved with the table view. When the reference count of the table view returns to zero and the view is being released, the IMAPITable implementation calls the callback function, passing the context in the ulCallerData parameter.

A common use of a CALLERRELEASE based callback function is to release the underlying table data object and not have to keep track of it during subsequent processing.