IMessage::GetAttachmentTable
Hace referencia a: Outlook 2013 | Outlook 2016
Devuelve la tabla de datos adjuntos del mensaje.
HRESULT GetAttachmentTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Parameters
ulFlags
[in] Máscara de bits de marcas relacionadas con la creación de la tabla. Se puede establecer la marca siguiente:
MAPI_UNICODE
Las columnas de cadena están en formato Unicode. Si no se establece la marca de MAPI_UNICODE, las columnas de cadena están en formato ANSI.
MAPI_DEFERRED_ERRORS
Permite que GetAttachmentTable se devuelva correctamente, posiblemente antes de que la tabla esté totalmente disponible para el cliente que realiza la llamada. Si la tabla no está disponible, realizar una llamada posterior a ella puede producir un error.
lppTable
[out] Puntero a un puntero a la tabla de datos adjuntos.
Valor devuelto
S_OK
La tabla de datos adjuntos se recuperó correctamente.
Comentarios
El método IMessage::GetAttachmentTable devuelve un puntero a la tabla de datos adjuntos del mensaje, que incluye información sobre todos los datos adjuntos del mensaje. Los clientes pueden obtener acceso a datos adjuntos solo a través de la tabla de datos adjuntos. Al recuperar el número de datos adjuntos de su propiedad PR_ATTACH_NUM (PidTagAttachNumber), un cliente puede usar varios de los métodos IMessage para trabajar con los datos adjuntos.
Hay una fila para cada dato adjunto. Para obtener una lista completa de las columnas de una tabla de datos adjuntos, consulte Tablas de datos adjuntos.
Normalmente, los datos adjuntos no aparecen en la tabla de datos adjuntos hasta que los datos adjuntos y el mensaje se han guardado con una llamada a IMAPIProp::SaveChanges. Las tablas de datos adjuntos son dinámicas. Si un cliente crea un nuevo archivo adjunto, elimina los datos adjuntos existentes o cambia una o varias propiedades una vez que se hayan realizado las llamadas a SaveChanges en los datos adjuntos del mensaje, la tabla de datos adjuntos se actualizará para reflejar la nueva información.
Algunas tablas de datos adjuntos admiten una amplia variedad de restricciones; otros no. La compatibilidad con restricciones depende de la implementación del proveedor del almacén de mensajes.
Cuando se abren inicialmente, las tablas de datos adjuntos no se ordenan necesariamente en ningún orden determinado.
Establecer la marca MAPI_UNICODE en el parámetro ulFlags afecta a las siguientes llamadas a la tabla de datos adjuntos:
IMAPITable::QueryColumns para recuperar el conjunto de columnas.
IMAPITable::QueryRows para recuperar filas.
IMAPITable::QuerySortOrder para recuperar el criterio de ordenación.
Al establecer la marca Unicode, se solicita que la información de las columnas de cadena devueltas de estas llamadas esté en formato Unicode. Sin embargo, dado que no todos los proveedores de almacén de mensajes admiten Unicode, establecer esta marca es solo una solicitud.