ITnef::SetProps
适用于:Outlook 2013 | Outlook 2016
设置封装邮件或附件的一个或多个属性的值,而不修改原始邮件或附件。
HRESULT SetProps(
ULONG ulFlags,
ULONG ulElemID,
ULONG cValues,
LPSPropValue lpProps
);
参数
ulFlags
[in]控制属性值设置方式的标志的位掩码。 可以设置以下标志:
TNEF_PROP_CONTAINED
仅对 ulElemID 参数指定的邮件或附件中的属性进行编码。
ulElemID
[in]附件的 PR_ATTACH_NUM (PidTagAttachNumber) 属性,该属性包含一个唯一标识其父邮件中的附件的数字。
cValues
[in]lpProps 参数指向的 SPropValue 结构中的属性值数。
lpProps
[in]指向 SPropValue 结构的指针,该结构包含要设置的属性的属性值。
返回值
S_OK
调用成功并返回了一个或多个预期值。
备注
传输提供程序、消息存储提供程序和网关调用 ITnef::SetProps 方法,以设置属性以包含在邮件或附件的封装中,而无需修改原始邮件或附件。 使用此调用设置的任何属性将覆盖封装消息中的现有属性。
只有使用 OpenTnefStream 或 OpenTnefStreamEx 函数的 TNEF_ENCODE 标志打开的 TNEF 对象才支持 SetProps。 可以使用此调用设置任意数量的属性。
注意
在调用 ITnef::Finish 方法之前,SetProps 的实际 TNEF 编码不会发生。 此功能意味着传入 SetProps 的指针必须在调用 Finish 后保持有效。 此时,可以释放或释放传递到 SetProps 调用中的所有对象和数据。