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
请求的接口不受 form 对象支持。
备注
表单查看者调用 IMAPIFormMgr::CreateForm 方法以打开表单以基于表单的邮件类创建新邮件。 CreateForm 通过创建该窗体的窗体服务器实例来打开该窗体,如给定窗体信息对象中所述。 如果需要, CreateForm 将调用 IMAPIFormMgr::P repareForm 方法将表单服务器代码下载到用户的磁盘。
pfrminfoToActivate 参数必须指向已正确解析的表单信息对象。
打开表单后,调用表单查看器必须使用 IPersistMessage 接口设置邮件,并且可以选择为表单设置视图上下文。 有关详细信息,请参阅 启动表单服务器。
MFCMAPI 引用
有关 MFCMAPI 示例代码,请参阅下表。
文件 | 函数 | 备注 |
---|---|---|
MAPIFormFunctions.cpp |
CreateAndDisplayNewMailInFolder |
MFCMAPI 使用 IMAPIFormMgr::CreateForm 方法在显示表单之前创建表单。 |