IMAPIFormContainer::CalcFormPropSet

适用于:Outlook 2013 | Outlook 2016

返回窗体容器中安装的所有窗体使用的属性数组。

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

参数

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。

备注

客户端应用程序调用 IMAPIFormContainer::CalcFormPropSet 方法,以获取表单容器中安装的所有窗体使用的属性数组。 IMAPIFormContainer::CalcFormPropSet 的工作方式类似于 IMAPIFormMgr::CalcFormPropSet 方法,只不过它在特定容器中注册的每个表单上操作。

针对实现者的说明

如果传递了MAPI_UNICODE,则不支持 Unicode 字符串的表单库提供程序应返回MAPI_E_BAD_CHARWIDTH。

给调用方的说明

IMAPIFormContainer::CalcFormPropSet 采用窗体属性集的交集或联合,具体取决于 ulFlags 参数中设置的标志,并返回包含生成的属性组的 SMAPIFormPropArray 结构。

如果客户端在 ulFlags 中传递MAPI_UNICODE标志,则所有返回的字符串都是 Unicode。

另请参阅

IMAPIFormMgr::CalcFormPropSet

SMAPIFormPropArray

IMAPIFormContainer : IUnknown