ITnef::EncodeRecips
Hace referencia a: Outlook 2013 | Outlook 2016
Codifica una vista para la tabla de destinatarios de un mensaje en el flujo de datos Transport-Neutral formato de encapsulación (TNEF) para el mensaje.
HRESULT EncodeRecips(
ULONG ulFlags,
LPMAPITABLE lpRecipientTable
);
Parameters
ulFlags
[entrada] Reservado; debe ser cero.
lpRecipientTable
[in] Puntero a la tabla de destinatarios para la que se codifica la vista. El parámetro lpRecipientTable puede ser NULL.
Valor devuelto
S_OK
La llamada se realizó correctamente y devolvió el valor o los valores esperados.
Comentarios
Los proveedores de transporte, los proveedores de almacén de mensajes y las puertas de enlace llaman al método ITnef::EncodeRecips para realizar la codificación TNEF para una vista de tabla de destinatarios determinada. La codificación TNEF es útil, por ejemplo, si un proveedor o puerta de enlace requiere un conjunto de columnas, un criterio de ordenación o una restricción determinados para la tabla de destinatarios.
Un proveedor o puerta de enlace pasa la vista de tabla que se va a codificar en el parámetro lpRecipientTable . La implementación de TNEF codifica la tabla de destinatarios con la vista dada, utilizando el conjunto de columnas, el criterio de ordenación, la restricción y la posición especificados. Si un proveedor o puerta de enlace pasa NULL en lpRecipientTable, TNEF obtiene la tabla de destinatarios del mensaje que se codifica mediante el método IMessage::GetRecipientTable y procesa cada fila de la tabla en el flujo TNEF mediante la configuración actual de la tabla.
Llamar a EncodeRecips con NULL en lpRecipientTable codifica así todos los destinatarios del mensaje y equivale a llamar al método ITnef::AddProps con la marca TNEF_PROP_INCLUDE en su parámetro ulFlags y la propiedad PR_MESSAGE_RECIPIENTS (PidTagMessageRecipients) en su parámetro lpPropList .
Tenga en cuenta que rara vez es necesario llamar a EncodeRecips a menos que haya un requisito para codificar una vista de tabla de destinatarios determinada. Los sistemas de mensajería externa casi siempre tienen facilidades para controlar listas de destinatarios que son lo suficientemente eficaces como para controlar las necesidades comunes de codificación de listas de destinatarios; por lo tanto, estos sistemas casi nunca requieren TNEF para este propósito.