IMAPIFormMgr::CalcFormPropSet

适用于:Outlook 2013 | Outlook 2016

返回一组窗体使用的属性数组。

HRESULT CalcFormPropSet(
  LPSMAPIFORMINFOARRAY pfrminfoarray,
  ULONG ulFlags,
  LPMAPIFORMPROPARRAY FAR * ppResults
);

参数

pfrminfoarray

[in]指向表单信息对象的数组的指针,这些对象标识要为其返回属性的窗体。

ulFlags

[in]一个标志的位掩码,用于控制 如何返回 ppResults 参数中的属性数组。 可以设置以下标志:

FORMPROPSET_INTERSECTION

返回的数组包含窗体属性的交集。

FORMPROPSET_UNION

返回的数组包含窗体属性的联合。

MAPI_UNICODE

数组中返回的字符串采用 Unicode 格式。 如果未设置MAPI_UNICODE标志,则字符串采用 ANSI 格式。

ppResults

[out]指向返回的 SMAPIFormPropArray 结构的指针的指针,该结构包含窗体使用的属性。

返回值

S_OK

调用成功并返回了一个或多个预期值。

MAPI_E_BAD_CHARWIDTH

已设置MAPI_UNICODE标志且实现不支持 Unicode,或者未设置MAPI_UNICODE且实现仅支持 Unicode。

备注

表单查看器调用 IMAPIFormMgr::CalcFormPropSet 方法以获取一组表单使用的属性数组。 CalcFormPropSet 采用这些窗体的属性集的交集或联合,具体取决于 ulFlags 参数中设置的标志,并返回包含生成的属性组的 SMAPIFormPropArray 结构。

针对实现者的说明

如果表单查看器传递 ulFlags 参数中的 MAPI_UNICODE 标志,则所有字符串都应作为 Unicode 字符串返回。 如果传递了MAPI_UNICODE,则不支持 Unicode 字符串的表单库提供程序应返回MAPI_E_BAD_CHARWIDTH。

另请参阅

SMAPIFormPropArray

IMAPIFormMgr : IUnknown