CALLERRELEASE

The CALLERRELEASE function prototype defines a callback function that releases a table data object.

Quick Info

Header file:

MAPIUTIL.H

Defined function implemented by:

Client applications and service providers

Defined function called by:

MAPI

 

void CALLERRELEASE(

    ULONG ulCallerData,

 

    LPTABLEDATA lpTblData,

 

    LPMAPITABLE lpVue

 

   );

 

 

Parameters

ulCallerData

[in] 32-bit data about the table data object to release.

lpTblData

[in] Pointer to the ITableData : IUnknown interfaceOOTYH1 for the table data object to release.

lpVue

[in] Pointer to the IMAPITable : IUnknown interface3YHK_52 for the table whose data is released. This table interface is an interface for the table object passed in the lppMAPITable parameter of the ITableData::HrGetView method211HM5R that created the object to release.

 

Return Values

None

Remarks

Client applications use the CALLERRELEASE function prototype to create a callback function to release a view on the underlying table data object without having to keep track of that object. After all views on a table data object are released, implementations of ITableData::HrGetView call the CALLERRELEASE function and then release the table data object underlying the views.