ITnef::EncodeRecips
Область применения: Outlook 2013 | Outlook 2016
Кодирует представление для таблицы получателей сообщения в потоке данных TNEF Transport-Neutral.
HRESULT EncodeRecips(
ULONG ulFlags,
LPMAPITABLE lpRecipientTable
);
Параметры
ulFlags
[in] ���������������; ������ ���� ����� ����.
lpRecipientTable
[в] Указатель на таблицу получателей, для которой закодировано представление. Параметр lpRecipientTable может иметь значение NULL.
Возвращаемое значение
S_OK
Вызов выполнен успешно и возвращает ожидаемое значение или значения.
Замечания
Поставщики транспорта, поставщики хранилищ сообщений и шлюзы вызывают метод ITnef::EncodeRecips для выполнения кодирования TNEF для определенного представления таблицы получателей. Кодировка TNEF полезна, например, если поставщику или шлюзу требуется определенный набор столбцов, порядок сортировки или ограничение для таблицы получателей.
Поставщик или шлюз передает представление таблицы для кодирования в параметре lpRecipientTable . Реализация TNEF кодирует таблицу получателей с заданным представлением, используя заданный набор столбцов, порядок сортировки, ограничение и позицию. Если поставщик или шлюз передает значение NULL в lpRecipientTable, TNEF получает таблицу получателей из закодированного сообщения с помощью метода IMessage::GetRecipientTable и обрабатывает каждую строку таблицы в поток TNEF с использованием текущих параметров таблицы.
Таким образом, вызов EncodeRecips с значением NULL в lpRecipientTable кодирует всех получателей сообщений и эквивалентен вызову метода ITnef::AddProps с флагом TNEF_PROP_INCLUDE в параметре ulFlags и свойством PR_MESSAGE_RECIPIENTS (PidTagMessageRecipients) в параметре lpPropList .
Обратите внимание, что редко требуется вызывать EncodeRecips , если не требуется кодировать определенное табличное представление получателя. Системы обмена сообщениями за границей почти всегда имеют возможности для обработки списков получателей, которые являются достаточно мощными для удовлетворения общих потребностей в кодировании списков получателей; таким образом, эти системы почти никогда не требуют TNEF для этой цели.