ITableData : IUnknown
Hace referencia a: Outlook 2013 | Outlook 2016
Proporciona métodos de utilidad para trabajar con tablas. MAPI proporciona objetos o objetos de datos de tabla que implementan ITableData para ayudar a los proveedores de servicios a realizar el mantenimiento de tablas. Para obtener un objeto de datos de tabla, los proveedores de servicios llaman a la función CreateTable .
| Propiedad | Valor |
|---|---|
| Archivo de encabezado: |
Mapiutil.h |
| Expuesto por: |
Objetos de datos de tabla |
| Implementado por: |
MAPI |
| Llamado por: |
Proveedores de servicios |
| Identificador de interfaz: |
IID_IMAPITableData |
| Tipo de puntero: |
LPTABLEDATA |
Orden de tabla virtual
| Member | Descripción |
|---|---|
|
HrGetView |
Crea una vista de tabla y devuelve un puntero a una implementación IMAPITable . |
|
HrModifyRow |
Inserta una nueva fila de tabla, posiblemente reemplazando una fila existente. |
|
HrDeleteRow |
Elimina una fila de tabla. |
|
HrQueryRow |
Recupera una fila de tabla. |
|
HrEnumRow |
Recupera una fila en función de su posición en la tabla. |
|
HrNotify |
Envía una notificación para una fila de tabla. |
|
HrInsertRow |
Inserta una fila de tabla. |
|
HrModifyRows |
Inserta varias filas de tabla, posiblemente reemplazando las filas existentes. |
|
HrDeleteRows |
Elimina varias filas de tabla. |
Comentarios
La implementación MAPI de ITableData funciona con tablas al contener todos los datos y las restricciones asociadas en la memoria, lo que hace que no sea adecuado para su uso con tablas muy grandes. No se admiten restricciones grandes ni operaciones complejas, como la categorización.
Los objetos de datos de tabla identifican filas mediante una columna de índice, una propiedad que se garantiza que tiene un valor único para cada fila. La mayoría de los proveedores de servicios usan la propiedad PR_INSTANCE_KEY (PidTagInstanceKey) como columna de índice. Las propiedades que tienen varios valores no se pueden usar como columna de índice.
Los objetos de datos de tabla generan una única notificación independientemente del número de filas afectadas por un cambio o eliminación. Si no existe una fila de destino en una operación, se agrega una fila.