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 方法创建窗体。

另请参阅

IMAPIFormMgr::PrepareForm

IPersistMessage : IUnknown

IMAPIFormMgr : IUnknown

MFCMAPI 代码示例

启动表单服务器