BuildDisplayTable

Hace referencia a: Outlook 2013 | Outlook 2016

Crea una tabla para mostrar a partir de los datos de página de propiedades contenidos en una o varias estructuras DTPAGE .

Propiedad	Valor
Archivo de encabezado:	Mapiutil.h
Implementado por:	MAPI
Llamado por:	Proveedores de servicios

STDAPI BuildDisplayTable(
  LPALLOCATEBUFFER lpAllocateBuffer,
  LPALLOCATEMORE lpAllocateMore,
  LPFREEBUFFER lpFreeBuffer,
  LPMALLOC lpMalloc,
  HINSTANCE hInstance,
  UINT cPages,
  LPDTPAGE lpPage,
  ULONG ulFlags,
  LPMAPITABLE * lppTable,
  LPTABLEDATA * lppTblData
);

Parameters

lpAllocateBuffer

[in] Puntero a la función MAPIAllocateBuffer , que se usará para asignar memoria.

lpAllocateMore

[in] Puntero a la función MAPIAllocateMore , que se usará para asignar memoria adicional.

lpFreeBuffer

[in] Puntero a la función MAPIFreeBuffer , que se usará para liberar memoria.

lpMalloc

Inusitado; debe establecerse en NULL.

hInstance

[in] Instancia de un objeto MAPI desde el que BuildDisplayTable recupera recursos.

cPages

[in] Recuento de estructuras DTPAGE en la matriz a la que apunta el parámetro lpPage .

lpPage

[in] Puntero a una matriz de estructuras DTPAGE que contienen información sobre las páginas de tabla para mostrar que se van a compilar.

ulFlags

[in] Máscara de bits de marcas. Se puede establecer la marca siguiente:

MAPI_UNICODE

Las cadenas pasadas están en formato Unicode. Si no se establece la marca de MAPI_UNICODE, las cadenas están en formato ANSI.

lppTable

[out] Puntero a un puntero a la tabla para mostrar, que expone la interfaz IMAPITable .

lppTblData

[entrada, salida] Puntero a un puntero a un objeto de datos de tabla que expone la interfaz ITableData en la tabla devuelta en el parámetro lppTable . Si no se desea ningún objeto de datos de tabla, lppTblData debe establecerse en NULL en lugar de en un valor de puntero.

Valor devuelto

Ninguno

Comentarios

MAPI usa las funciones a las que apunta lpAllocateBuffer, lpAllocateMore y lpFreeBuffer para la mayoría de la asignación y desasignación de memoria, en particular para asignar memoria para su uso por las aplicaciones cliente al llamar a interfaces de objeto como IMAPIProp::GetProps e IMAPITable::QueryRows.

Notas para los llamadores

Todo lo posible se lee desde el recurso de cuadro de diálogo, incluidos:

• El título de la página, es decir, el miembro ulbLpszLabel de la estructura DTBLPAGE leído del título del cuadro de diálogo en el recurso.

• Todos los títulos de control, es decir, los miembros ulbLpszLabel de otras estructuras de control leen desde el texto del control del recurso.

BuildDisplayTable sobrescribe todo lo que se pasa en las estructuras de control de entrada con información del recurso de diálogo, lo que significa que el autor de la llamada de BuildDisplayTable no puede especificar dinámicamente títulos de página o control. Los autores de llamadas que necesitan hacer esto pueden hacer que BuildDisplayTable devuelva el objeto de datos de tabla en lppTableData y cambie las filas en él; o pueden crear la tabla para mostrar manualmente en un objeto de datos de tabla en su lugar.

Si lppTableData no está establecido en NULL, el proveedor es responsable de liberar el objeto de datos de tabla cuando termine con la tabla para mostrar.