Поделиться через

GetAttribIMsgOnIStg

  • Статья

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

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

Свойство Значение
Файл заголовка:
 Imessage.h
Реализовано в:
 MAPI
Вызывающая сторона:
 Клиентские приложения и поставщики хранилища сообщений
 
HRESULT GetAttribIMsgOnIStg(
  LPVOID lpObject,
  LPSPropTagArray lpPropTagArray,
  LPSPropAttrArray FAR * lppPropAttrArray
);

Параметры

lpObject

[в] Указатель на объект IMessage , полученный из функции OpenIMsgOnIStg .

lpPropTagArray

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

lppPropAttrArray

[out] Указатель на указатель на возвращенную структуру SPropAttrArray , содержащую извлеченные атрибуты свойства.

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

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.

Число и позиции атрибутов в параметре lppPropAttrArray соответствуют числу и позициям тегов свойств в параметре lpPropTagArray .