IMAPIFormMgr::ResolveMultipleMessageClasses
适用于:Outlook 2013 | Outlook 2016
将一组消息类解析为窗体容器中的窗体,并返回这些窗体的表单信息对象的数组。
HRESULT ResolveMultipleMessageClasses(
LPSMESSAGECLASSARRAY pMsgClasses,
ULONG ulFlags,
LPMAPIFOLDER pFolderFocus,
LPSMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
参数
pMsgClasses
[in]指向数组的指针,该数组包含要解析的消息类的名称。
ulFlags
[in]控制消息类解析方式的标志的位掩码。 可以设置以下标志:
MAPIFORM_EXACTMATCH
仅应解析完全匹配的消息类字符串。
MAPIFORM_LOCALONLY
不要包含缓存的表单。
pFolderFocus
[in]指向包含要解析其邮件类的窗体的文件夹的指针。 pFolderFocus 参数可以为 NULL。
ppfrminfoarray
[out]指向窗体信息对象数组的指针的指针。 如果表单查看器在 pMsgClasses 参数中传递 NULL,则 ppfrminfoarray 参数包含容器中所有窗体的表单信息对象。
返回值
S_OK
调用成功,并返回了预期的值。
备注
表单查看者调用 IMAPIFormMgr::ResolveMultipleMessageClasses 方法,将一组消息类解析为表单容器中的表单。 ppfrminfoarray 中返回的表单信息对象的数组提供了对每个窗体属性的进一步访问。
给调用方的说明
若要将一组邮件类解析为窗体,表单查看器会传入要解析的邮件类名称数组。 若要强制解析为精确 (也就是说,若要防止在完全匹配的表单服务器不可用时解析为消息类的基类,) 可以在 ulFlags 参数中传递MAPIFORM_EXACTMATCH标志。
消息类名称始终是 ANSI 字符串,从不为 Unicode。
如果无法将邮件类解析为窗体,则窗体信息数组中为该消息类返回 NULL。 因此,即使方法返回S_OK,表单查看者也不应假定所有消息类都已成功解析。 相反,表单查看者应检查返回数组中的值。