通过

IMAPIMessageSite::NewMessage

  • 项目

适用于：Outlook 2013 | Outlook 2016

创建新消息。

HRESULT NewMessage(
  ULONG fComposeInFolder,
  LPMAPIFOLDER pFolderFocus,
  LPPERSISTMESSAGE pPersistMessage,
  LPMESSAGE FAR * ppMessage,
  LPMAPIMESSAGESITE FAR * ppMessageSite,
  LPMAPIVIEWCONTEXT FAR * ppViewContext
);

参数

fComposeInFolder

[in]指示应在哪个文件夹中撰写邮件。 如果变量为 FALSE，则忽略 pFolderFocus 参数，并且表单查看器可以在任何文件夹中撰写邮件。 如果变量为 TRUE 且 pFolderFocus 参数中传递 NULL，则邮件将组成当前文件夹中。 如果变量为 TRUE，并在 pFolderFocus 中传递非 NULL 值，则邮件将包含在 pFolderFocus 指向的文件夹中。

pFolderFocus

[in]指向创建新邮件的文件夹的指针。

pPersistMessage

[in]指向新窗体的窗体对象的指针。

ppMessage

[out]指向指向新消息的指针的指针。

ppMessageSite

[out]指向指向新消息的消息站点对象的指针的指针。

ppViewContext

[out]指向视图上下文的指针的指针，该上下文适合传递给包含新消息的新窗体。 如果窗体实现自己的视图上下文，则可以在 ppViewContext 参数中传递 NULL。

返回值

S_OK

调用成功，并返回了预期的值。

备注

窗体对象调用 IMAPIMessageSite：：NewMessage 方法以创建新消息。 窗体使用 NewMessage 从其视图中获取新邮件和关联的消息站点。 然后，它可以修改新消息。

还可以通过在 ppViewContext 参数中传入非 NULL 值来获取关联的视图上下文。 此视图上下文可以直接使用，也可以将其聚合并传递给新消息。 如果需要完整的实现，请在 ppViewContext 中传递 NULL。

有关与表单服务器相关的接口的列表，请参阅 MAPI 表单接口。

MFCMAPI 引用

有关 MFCMAPI 示例代码，请参阅下表。

文件 函数 Comment
MyMAPIFormViewer.cpp
 CMyMAPIFormViewer：：NewMessage
 MFCMAPI 使用 IMAPIMessageSite：：NewMessage 方法创建新邮件、实例化新的表单查看器，并调用 SetPersist 在表单查看器上设置消息。 最后，它将表单查看器作为邮件网站返回。

另请参阅

IMAPIViewContext : IUnknown

IMAPIMessageSite : IUnknown

MFCMAPI 代码示例

MAPI 表单接口