IMAPIFormMgr::CreateForm
适用于:Outlook 2013 | Outlook 2016
打开窗体以基于窗体的邮件类创建新邮件。
HRESULT CreateForm(
ULONG_PTR ulUIParam,
ULONG ulFlags,
IMAPIFormInfo pfrminfoToActivate,
REFIID refiidToAsk,
LPVOID FAR * ppvObj
);
参数
ulUIParam
[in]打开窗体时显示的进度指示器的父窗口的句柄。 除非在 ulFlags 参数中设置了 MAPI_DIALOG 标志,否则忽略 ulUIParam 参数。
ulFlags
[in]控制窗体的打开方式的标志的位掩码。 可以设置以下标志:
MAPI_DIALOG
显示用户界面以提供状态或提示用户了解详细信息。 如果未设置此标志,则不显示任何用户界面。
pfrminfoToActivate
[in]指向用于打开窗体的窗体信息对象的指针。
refiidToAsk
[in]指向接口标识符的指针 (IID) ,以便为创建的表单对象返回接口。 refiidToAsk 参数不能为 NULL。
ppvObj
[out]指向返回接口的指针的指针。
返回值
S_OK
调用成功,并返回了预期的值。
MAPI_E_NO_INTERFACE
表单对象不支持请求的接口。
备注
表单查看者调用 IMAPIFormMgr::CreateForm 方法以打开窗体,以基于窗体的邮件类创建新邮件。 CreateForm 通过为该窗体创建窗体服务器的实例来打开窗体,如给定的表单信息对象中所述。 如果需要, CreateForm 调用 IMAPIFormMgr::P repareForm 方法将表单服务器代码下载到用户的磁盘。
pfrminfoToActivate 参数必须指向已正确解析的表单信息对象。
打开窗体后,调用表单查看器必须使用 IPersistMessage 接口设置消息,并且可以选择性地为表单设置视图上下文。 有关详细信息,请参阅 启动表单服务器。
MFCMAPI 引用
有关 MFCMAPI 示例代码,请参阅下表。
文件 | 函数 | Comment |
---|---|---|
MAPIFormFunctions.cpp |
CreateAndDisplayNewMailInFolder |
MFCMAPI 在显示窗体之前使用 IMAPIFormMgr::CreateForm 方法创建窗体。 |