SetAttribIMsgOnIStg

Область применения: Outlook 2013 | Outlook 2016

Задает или изменяет атрибуты свойств объекта IMessage , предоставляемого функцией OpenIMsgOnIStg .

Свойство	Значение
Файл заголовка:	Imessage.h
Реализовано в:	MAPI
Вызывающая сторона:	Клиентские приложения и поставщики хранилища сообщений

HRESULT SetAttribIMsgOnIStg(
  LPVOID lpObject,
  LPSPropTagArray lpPropTags,
  LPSPropAttrArray lpPropAttrs,
  LPSPropProblemArray FAR * lppPropProblems
);

Параметры

lpObject

[в] Указатель на объект, для которого задаются атрибуты свойства.

lpPropTags

[в] Указатель на структуру SPropTagArray , содержащую массив тегов свойств, указывающих свойства, для которых задаются атрибуты свойств.

lpPropAttrs

[в] Указатель на структуру SPropAttrArray , в которой перечислены атрибуты свойства, которые необходимо задать.

lppPropProblems

[out] Указатель на возвращенную структуру SPropProblemArray , содержащую набор проблем со свойствами. Эта структура определяет проблемы, возникающие, если SetAttribIMsgOnIStg удалось задать некоторые свойства, но не все. Если указатель на NULL передается в параметре lppPropProblems , массив проблем со свойствами не возвращается, даже если некоторые свойства не заданы.

Возвращаемое значение

S_OK

����� ������� � ������ ��������� ��������� ��� ��������.

MAPI_W_ERRORS_RETURNED

Вызов в целом выполнен успешно, но доступ к одному или нескольким свойствам не удалось получить, и они были возвращены с типом свойства PT_ERROR.

Замечания

Доступ к атрибутам свойств можно получить только для объектов свойств, то есть объектов, реализующих интерфейс IMAPIProp : IUnknown . Чтобы сделать свойства MAPI доступными для объекта структурированного хранилища OLE, OpenIMsgOnIStg создает объект IMessage : IMAPIProp поверх объекта OLE IStorage . Атрибуты свойств для таких объектов можно задать или изменить с помощью SetAttribIMsgOnIStg и получить с помощью GetAttribIMsgOnIStg.

ПримечаниеGetAttribIMsgOnIStg и SetAttribIMsgOnIStg не работают со всеми объектами IMessage . Они допустимы только для объектов IMessage-on-IStorage, возвращенных OpenIMsgOnIStg.

В параметре lpPropAttrs число и позиция атрибутов должны соответствовать числу и положению тегов свойств, переданных в параметре lpPropTags .

Функция SetAttribIMsgOnIStg используется для создания свойств сообщения только для чтения, если это требуется для схемы IMessage . Поставщик хранилища примеров сообщений использует его для этой цели. Дополнительные сведения см. в разделе Сообщения.