CALLERRELEASE

Область применения: Outlook 2013 | Outlook 2016

Определяет функцию обратного вызова, которая может освободить объект данных таблицы при освобождении табличного представления.

Свойство	Значение
Файл заголовка:	Mapiutil.h
Определена функция, реализованная:	Клиентские приложения и поставщики услуг
Определенная функция, вызываемая:	MAPI

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

Параметры

ulCallerData

[в] Данные вызывающего объекта, сохраненные MAPI с табличным представлением и передаваемые в функцию обратного вызова на основе CALLERRELEASE . Данные предоставляют контекст о освобождаемом представлении таблицы.

lpTblData

[в] Указатель на интерфейс ITableData: IUnknown для объекта данных таблицы, лежащего в основе освобождаемого табличного представления.

lpVue

[в] Указатель на интерфейс IMAPITable: IUnknown для освобождаемого табличного представления. Это интерфейс для объекта таблицы, возвращаемого в параметре lppMAPITable метода ITableData::HrGetView , создавшего объект для освобождения.

Возвращаемое значение

Нет

Замечания

Клиентское приложение или поставщик услуг, заполнили объект данных таблицы, может вызвать ITableData::HrGetView для создания отсортированного представления таблицы только для чтения. Вызов HrGetView передает указатель на функцию обратного вызова на основе CALLERRELEASE , а также контекст для сохранения в табличном представлении. Когда количество ссылок табличного представления возвращается к нулю и представление освобождается, реализация IMAPITable вызывает функцию обратного вызова, передав контекст в параметре ulCallerData .

Функция обратного вызова на основе CALLERRELEASE часто используется для освобождения базового объекта данных таблицы и не требуется отслеживать его во время последующей обработки.