IMAPIFormContainer::ResolveMultipleMessageClasses
适用于:Outlook 2013 | Outlook 2016
将一组消息类解析为窗体容器中的窗体,并返回这些窗体的表单信息对象的数组。
HRESULT ResolveMultipleMessageClasses(
LPSMESSAGECLASSARRAY pMsgClassArray,
ULONG ulFlags,
LPSMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
参数
pMsgClassArray
[in]指向数组的指针,该数组包含要解析的消息类的名称。 消息类名称始终是 ANSI 字符串,从不为 Unicode。
ulFlags
[in]控制消息类解析方式的标志的位掩码。 可以设置以下标志:
MAPIFORM_EXACTMATCH
仅应解析完全匹配的消息类字符串。
ppfrminfoarray
[out]指向窗体信息对象数组的指针的指针。 如果客户端应用程序在 pMsgClassArray 参数中传递 NULL, 则 ppfrminfoarray 参数包含容器中所有窗体的表单信息对象。
返回值
S_OK
调用成功,并返回了预期的值。
备注
客户端应用程序调用 IMAPIFormContainer::ResolveMultipleMessageClasses 方法,将一组消息类解析为表单容器中的表单。 ppfrminfoarray 参数中返回的表单信息对象的数组提供了对每个窗体属性的进一步访问。
给调用方的说明
若要将一组消息类解析为窗体,请传入要解析的消息类名称数组。 若要强制解析 (即防止解析为消息类) 的基类,可以在 ulFlags 参数中传递MAPIFORM_EXACTMATCH标志。
如果无法将邮件类解析为窗体,则窗体信息数组中为该消息类返回 NULL。 因此,即使 方法返回S_OK,也不要假定所有消息类都已成功解析。 相反,检查返回数组中的值。
MFCMAPI 引用
有关 MFCMAPI 示例代码,请参阅下表。
文件 | 函数 | Comment |
---|---|---|
FormContainerDlg.cpp |
CFormContainerDlg::OnResolveMultipleMessageClasses |
MFCMAPI 使用 IMAPIFormContainer::ResolveMultipleMessageClasses 方法查找与一组消息类关联的表单。 |