IMAPIMessageSite::MoveMessage

适用于:Outlook 2013 | Outlook 2016

将当前邮件移动到文件夹。

HRESULT MoveMessage(
  LPFOLDER pFolderDestination,
  LPMAPIVIEWCONTEXT pViewContext,
  LPCRECT prcPosRect
);

参数

pFolderDestination

[in]指向要移动邮件的文件夹的指针。

pViewContext

[in]指向视图上下文对象的指针。

prcPosRect

[in]指向包含当前窗体窗口大小和位置的 RECT 结构的指针。 显示的下一个窗体也使用此窗口矩形。

返回值

S_OK

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

MAPI_E_NO_SUPPORT

此消息站点不支持此操作。

备注

表单对象调用 IMAPIMessageSite::MoveMessage 方法将当前邮件移动到新文件夹。

针对实现者的说明

在将邮件实际移动到新文件夹之前,表单查看器的 MoveMessage 实现必须调用 IMAPIViewContext::ActivateNext 方法,传递VCDIR_MOVE标志。 若要获取窗体窗口使用的 RECT 结构,请调用 Windows GetWindowRect 函数。

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

给调用方的说明

在 MoveMessage 返回后,窗体必须为当前邮件检查,如果不存在表单,则自行关闭。

MFCMAPI 引用

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

文件 函数 Comment
MyMAPIFormViewer.cpp
CMyMAPIFormViewer::MoveMessage
未实现。

另请参阅

IMAPIViewContext::ActivateNext

IMAPIMessageSite : IUnknown

MFCMAPI 代码示例

MAPI 表单接口