ITnef::AddProps
Область применения: Outlook 2013 | Outlook 2016
Позволяет вызывающей услуге или шлюзу добавлять свойства в инкапсуляцию сообщения или вложения.
HRESULT AddProps(
ULONG ulFlags,
ULONG ulElemID,
LPVOID lpvData,
LPSPropTagArray lpPropList
);
Параметры
ulFlags
[в] Битовая маска флагов, управляющая тем, как свойства включаются в инкапсуляцию или исключаются из нее. Можно задать следующие флаги:
TNEF_PROP_ATTACHMENTS_ONLY
Кодирует только свойства в параметре lpPropList , которые являются частью вложений в сообщении.
TNEF_PROP_CONTAINED
Кодирует только свойства из вложения, указанного параметром ulElemID . Если параметр lpvData не имеет значение NULL, указанные данные записываются в инкапсуляцию вложения в файле, указанном свойством PR_ATTACH_TRANSPORT_NAME (PidTagAttachTransportName).
TNEF_PROP_CONTAINED_TNEF
Кодирует только свойства сообщения или вложения, указанные параметром ulElemID . Если этот флаг установлен, значение в lpvData должно быть указателем IStream .
TNEF_PROP_EXCLUDE
Кодирует все свойства, не указанные в параметре lpPropList .
TNEF_PROP_INCLUDE
Кодирует все свойства, указанные в lpPropList.
TNEF_PROP_MESSAGE_ONLY
Кодирует только те свойства, которые указаны в lpPropList , которые являются частью самого сообщения.
ulElemID
[в] Свойство PR_ATTACH_NUM вложения (PidTagAttachNumber), содержащее число, однозначно определяющее вложение в его родительском сообщении. Параметр ulElemID используется при запросе специальной обработки для вложения. Параметр ulElemID должен иметь значение 0, если в параметре ulFlags не установлен флаг TNEF_PROP_CONTAINED или TNEF_PROP_CONTAINED_TNEF.
lpvData
[в] Указатель на данные вложения, используемый для замены данных вложения, указанного в ulElemID. Параметр lpvData должен иметь значение NULL, если TNEF_PROP_CONTAINED или TNEF_PROP_CONTAINED_TNEF не задано в ulFlags.
lpPropList
[в] Указатель на список свойств, которые необходимо включить или исключить из инкапсуляции.
Возвращаемое значение
S_OK
����� ������� � ������ ��������� ��������� ��� ��������.
Замечания
Поставщики транспорта, поставщики хранилищ сообщений и шлюзы вызывают метод ITnef::AddProps для перечисления свойств, которые должны быть включены в обработку сообщения или вложения Transport-Neutral (TNEF). С помощью последовательных вызовов поставщик или шлюз может указать список свойств для добавления и кодирования или исключения из кодирования. Поставщики и шлюзы также могут использовать AddProps для предоставления сведений о любых специальных вложениях обработки.
AddProps поддерживается только для объектов TNEF, открытых с помощью флага TNEF_ENCODE для функции OpenTnefStream или OpenTnefStreamEx .
Обратите внимание, что фактическое кодирование TNEF для AddProps не выполняется до вызова метода ITnef::Finish . Эта функция означает, что указатели, передаваемые в AddProps, должны оставаться действительными до тех пор, пока не будет выполнен вызов Finish . На этом этапе все объекты и данные, передаваемые с помощью вызовов AddProps , могут быть освобождены или освобождены.
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| File.cpp |
SaveToTNEF |
MFCMAPI использует метод ITnef::AddProps для копирования свойств из сообщения в поток TNEF. |