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 在表单查看器上设置消息。 最后，它将表单查看器作为邮件网站返回。 |