CreateTable
Hace referencia a: Outlook 2013 | Outlook 2016
Crea estructuras y un identificador de objeto para un objeto ITableData que se puede usar para crear contenido de tabla.
| Propiedad | Valor |
|---|---|
| Archivo de encabezado: |
Mapiutil.h |
| Implementado por: |
MAPI |
| Llamado por: |
Aplicaciones cliente y proveedores de servicios |
SCODE CreateTable(
LPCIID lpInterface,
ALLOCATEBUFFER FAR * lpAllocateBuffer,
ALLOCATEMORE FAR * lpAllocateMore,
FREEBUFFER FAR * lpFreeBuffer,
LPVOID lpvReserved,
ULONG ulTableType,
ULONG ulPropTagIndexColumn,
LPSPropTagArray lpSPropTagArrayColumns,
LPTABLEDATA FAR * lppTableData
);
Parameters
lpInterface
[in] Puntero a un identificador de interfaz (IID) para el objeto de datos de tabla. El identificador de interfaz válido es IID_IMAPITableData. Pasar NULL en el parámetro lpInterface también hace que el objeto de datos de tabla devuelto en el parámetro lppTableData se convierta en la interfaz estándar de un objeto de datos de tabla.
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.
lpvReserved
[entrada] Reservado; debe ser cero.
ulTableType
[in] Un tipo de tabla que está disponible para una aplicación cliente o un proveedor de servicios como parte de IMAPITable::GetStatus devuelve datos en sus vistas de tabla. Los posibles valores son:
TBLTYPE_DYNAMIC
El contenido de la tabla es dinámico y puede cambiar a medida que cambian los datos subyacentes.
TBLTYPE_KEYSET
Las filas de la tabla son fijas, pero los valores de estas filas son dinámicos y pueden cambiar a medida que cambian los datos subyacentes.
TBLTYPE_SNAPSHOT
La tabla es estática y el contenido no cambia cuando cambian los datos subyacentes.
ulPropTagIndexColumn
[in] Número de índice de la columna que se va a usar al cambiar los datos de la tabla.
lpSPropTagArrayColumns
[in] Puntero a una estructura SPropTagArray que contiene una matriz de etiquetas de propiedad que indica las propiedades necesarias en la tabla para la que el objeto contiene datos.
lppTableData
[out] Puntero a un puntero al objeto de datos de tabla devuelto.
Valor devuelto
S_OK
La llamada se ha realizado correctamente y devuelva el valor esperado o los valores.
Comentarios
Los parámetros de entrada lpAllocateBuffer, lpAllocateMore y lpFreeBuffer apuntan a las funciones MAPIAllocateBuffer, MAPIAllocateMore y MAPIFreeBuffer , respectivamente. Una aplicación cliente que llama a CreateTable pasa punteros a las funciones MAPI que se acaban de denominar; un proveedor de servicios pasa los punteros a estas funciones que recibió en su llamada de inicialización o se recuperó con una llamada al método IMAPISupport::GetMemAllocRoutines .