GetAttribIMsgOnIStg

适用于:Outlook 2013 | Outlook 2016

检索 OpenIMsgOnIStg 函数提供的 IMessage 对象的属性属性。

属性
标头文件:
Imessage.h
实现者:
MAPI
调用者:
客户端应用程序和消息存储提供程序
HRESULT GetAttribIMsgOnIStg(
  LPVOID lpObject,
  LPSPropTagArray lpPropTagArray,
  LPSPropAttrArray FAR * lppPropAttrArray
);

参数

lpObject

[in]指向从 OpenIMsgOnIStg 函数获取的 IMessage 对象的指针。

lpPropTagArray

[in]指向 SPropTagArray 结构的指针,该结构包含属性标记数组,指示要为其检索属性的属性。

lppPropAttrArray

[out]指向返回的 SPropAttrArray 结构的指针的指针,该结构包含检索到的属性属性。

返回值

S_OK

调用成功,并返回了预期的值。

MAPI_W_ERRORS_RETURNED

调用总体成功,但无法访问一个或多个属性,并且返回的属性类型为 PT_ERROR。

备注

只能在属性对象(即实现 IMAPIProp 的对象)上访问属性属性: IUnknown 接口。 为了使 MAPI 属性在 OLE 结构化存储对象上可用,OpenIMsgOnIStg 在 OLE IStorage 对象之上生成 IMessage : IMAPIProp 对象。 可以使用 SetAttribIMsgOnIStg 设置或更改此类对象的属性属性,并使用 GetAttribIMsgOnIStg 检索。

注意

GetAttribIMsgOnIStgSetAttribIMsgOnIStg 不对所有 IMessage 对象进行操作。 它们仅对 OpenIMsgOnIStg 返回的 IStorage 上的 IStorage 对象有效。

lppPropAttrArray 参数中属性的数量和位置对应于 lpPropTagArray 参数中属性标记的数量和位置。