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 调用中的所有对象和数据。

另请参阅

ITnef::Finish

OpenTnefStream

OpenTnefStreamEx

PidTagAttachNumber 规范属性

SPropValue

ITnef : IUnknown