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 检索。
注意
GetAttribIMsgOnIStg 和 SetAttribIMsgOnIStg 不对所有 IMessage 对象进行操作。 它们仅对 OpenIMsgOnIStg 返回的 IStorage 上的 IStorage 对象有效。
lppPropAttrArray 参数中属性的数量和位置对应于 lpPropTagArray 参数中属性标记的数量和位置。