IMessage::GetRecipientTable
Hace referencia a: Outlook 2013 | Outlook 2016
Devuelve la tabla de destinatarios del mensaje.
HRESULT GetRecipientTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Parameters
ulFlags
[in] Máscara de bits de marcas que controla la devolución de la tabla. Se pueden establecer las siguientes marcas:
MAPI_DEFERRED_ERRORS
Permite que GetRecipientTable 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.
MAPI_UNICODE
Las columnas de cadena deben estar en formato Unicode. Si no se establece la marca de MAPI_UNICODE, las columnas de cadena deben estar en formato ANSI.
lppTable
[out] Puntero a un puntero a la tabla de destinatarios.
Valor devuelto
S_OK
La tabla de destinatarios se devolvió correctamente.
Comentarios
El método IMessage::GetRecipientTable devuelve un puntero a la tabla de destinatarios del mensaje, que incluye información sobre todos los destinatarios del mensaje. Hay una fila para cada destinatario.
Las tablas de destinatarios tienen un conjunto de columnas diferente en función de si se ha enviado el mensaje. Para obtener una lista completa de las columnas de una tabla de destinatarios, consulte Tablas de destinatarios.
Algunas tablas de destinatarios admiten una amplia variedad de restricciones; otros no. La compatibilidad con restricciones depende de la implementación del proveedor del almacén de mensajes.
Establecer la marca MAPI_UNICODE en el parámetro ulFlags afecta a las siguientes llamadas a la tabla de destinatarios:
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.
Notas para los llamadores
Puede cambiar una tabla de destinatarios mientras está abierta llamando al método IMessage::ModifyRecipients . ModifyRecipients agrega destinatarios, elimina destinatarios o modifica las propiedades del destinatario.