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 库中存在类标识符的假设下工作。