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。