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。