ITnef::SetProps
Область применения: Outlook 2013 | Outlook 2016
Задает значение одного или нескольких свойств для инкапсулированного сообщения или вложения без изменения исходного сообщения или вложения.
HRESULT SetProps(
ULONG ulFlags,
ULONG ulElemID,
ULONG cValues,
LPSPropValue lpProps
);
Параметры
ulFlags
[в] Битовая маска флагов, управляющая настройкой значений свойств. Можно задать следующий флаг:
TNEF_PROP_CONTAINED
Кодирует только свойства сообщения или вложения, указанные параметром ulElemID .
ulElemID
[в] Свойство PR_ATTACH_NUM вложения (PidTagAttachNumber), содержащее число, однозначно определяющее вложение в его родительском сообщении.
cValues
[в] Количество значений свойств в структуре SPropValue , на которое указывает параметр lpProps .
lpProps
[в] Указатель на структуру SPropValue , содержащую значения свойств, которые необходимо задать.
Возвращаемое значение
S_OK
Вызов выполнен успешно и возвращает ожидаемое значение или значения.
Замечания
Поставщики транспорта, поставщики хранилища сообщений и шлюзы вызывают метод ITnef::SetProps , чтобы задать свойства для включения в инкапсуляцию сообщения или вложения без изменения исходного сообщения или вложения. Все свойства, заданные этим вызовом, переопределяют существующие свойства в инкапсулированном сообщении.
SetProps поддерживается только для объектов TNEF, открытых с помощью флага TNEF_ENCODE для функции OpenTnefStream или OpenTnefStreamEx . С помощью этого вызова можно задать любое количество свойств.
Примечание.
Фактическое кодирование TNEF для SetProps не выполняется до тех пор, пока не будет вызван метод ITnef::Finish . Эта функция означает, что указатели, передаваемые в SetProps, должны оставаться действительными до тех пор, пока не будет выполнен вызов Finish . На этом этапе все объекты и данные, передаваемые в вызовы SetProps , могут быть освобождены или освобождены.