IMAPIFormMgr::ResolveMessageClass
适用于:Outlook 2013 | Outlook 2016
将消息类解析为窗体容器中的窗体,并返回该窗体的表单信息对象。
HRESULT ResolveMessageClass(
LPCSTR szMsgClass,
ULONG ulFlags,
LPMAPIFOLDER pFolderFocus,
LPMAPIFORMINFO FAR * ppResult
);
参数
szMsgClass
[in]一个字符串,用于命名要解析的消息类。
ulFlags
[in]控制消息类解析方式的标志的位掩码。 可以设置以下标志:
MAPIFORM_EXACTMATCH
仅应解析完全匹配的消息类字符串。
pFolderFocus
[in]指向包含要解析的邮件的文件夹的指针。 pFolderFocus 参数可以为 NULL。
ppResult
[out]指向返回的表单信息对象的指针的指针。
返回值
S_OK
调用成功,并返回了预期的值。
MAPI_E_NOT_FOUND
在 szMsgClass 参数中传递的消息类与表单库中任何窗体的消息类都不匹配。
备注
表单查看者调用 IMAPIFormMgr::ResolveMessageClass 方法,将消息类解析为窗体容器中的窗体。 ppResult 参数中返回的表单信息对象提供对具有给定消息类的表单属性的进一步访问。
给调用方的说明
若要将邮件类解析为窗体,表单查看器会传入要解析的邮件类的名称,例如“ IPM.HelpDesk.Software
”。 若要强制解析为精确 (也就是说,为了防止在完全匹配的表单服务器) 不可用时解析为消息类的基类,可以在 ulFlags 参数中传递MAPIFORM_EXACTMATCH标志。 如果 pFolderFocus 参数为 NULL,则邮件类解析过程不会搜索文件夹容器。
搜索的容器的顺序取决于表单库提供程序的实现。 默认表单库提供程序首先搜索本地容器,然后搜索传入文件夹的文件夹容器、个人表单容器,最后搜索组织容器。
消息类名称始终是 ANSI 字符串,从不为 Unicode。
解析的邮件类的类标识符作为表单信息对象的一部分返回。 在表单查看器调用 IMAPIFormMgr::P repareForm 方法或 IMAPIFormMgr::CreateForm 方法之前,表单查看器不应假定类标识符存在于 OLE 库中。