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 方法在显示表单之前创建表单。

另请参阅

IMAPIFormMgr::PrepareForm

IPersistMessage : IUnknown

IMAPIFormMgr : IUnknown

MFCMAPI 代码示例

启动表单服务器