CALLERRELEASE

Hace referencia a: Outlook 2013 | Outlook 2016

Define una función de devolución de llamada que puede liberar un objeto de datos de tabla cuando se libera una vista de tabla.

Propiedad	Valor
Archivo de encabezado:	Mapiutil.h
Función definida implementada por:	Aplicaciones cliente y proveedores de servicios
Función definida a la que llama:	MAPI

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

Parameters

ulCallerData

[in] Datos del llamador guardados por MAPI con la vista de tabla y pasados a la función de devolución de llamada basada en CALLERRELEASE . Los datos proporcionan contexto sobre la vista de tabla que se va a liberar.

lpTblData

[in] Puntero a la interfaz ITableData : IUnknown para el objeto de datos de tabla subyacente a la vista de tabla que se va a liberar.

lpVue

[in] Puntero a la interfaz IMAPITable : IUnknown para la vista de tabla que se va a liberar. Se trata de una interfaz para el objeto de tabla devuelto en el parámetro lppMAPITable del método ITableData::HrGetView que creó el objeto que se va a liberar.

Valor devuelto

Ninguno

Comentarios

Una aplicación cliente o un proveedor de servicios que ha rellenado un objeto de datos de tabla puede llamar a ITableData::HrGetView para crear una vista ordenada de solo lectura de la tabla. La llamada a HrGetView pasa un puntero a una función de devolución de llamada basada en CALLERRELEASE y también a un contexto que se va a guardar con la vista de tabla. Cuando el recuento de referencias de la vista de tabla vuelve a cero y se libera la vista, la implementación de IMAPITable llama a la función de devolución de llamada, pasando el contexto en el parámetro ulCallerData .

Un uso común de una función de devolución de llamada basada en CALLERRELEASE es liberar el objeto de datos de tabla subyacente y no tener que realizar un seguimiento de él durante el procesamiento posterior.