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,表单查看者也不应假定所有消息类都已成功解析。 相反,表单查看者应检查返回数组中的值。

另请参阅

IMAPIFormMgr::ResolveMessageClass

IMAPIFormMgr : IUnknown