IMsgStore::NotifyNewMail

适用于:Outlook 2013 | Outlook 2016

通知消息存储,新邮件已到达。 此方法仅由 MAPI 后台处理程序调用。

HRESULT NotifyNewMail(
  LPNOTIFICATION lpNotification
);

参数

lpNotification

[in]指向描述新消息通知的 NOTIFICATION 结构的指针。

返回值

S_OK

已成功通知消息存储。

备注

MAPI 后台处理程序调用 IMsgStore::NotifyNewMail 方法,以通知消息存储邮件已准备好传递。

针对实现者的说明

调用 NotifyNewMail 时,向所有已注册的客户端发送新邮件通知。 如果选择使用支持对象方法,或者使用自己的实现,可以通过调用 IMAPISupport::Notify 来发送通知。 已注册的客户端是调用 IMsgStore::Advise 并将 lpEntryID 参数设置为 NULL 并将 ulEventMask 参数设置为 fnevNewMail 的客户端。

不要修改或释放用于描述新邮件通知的 NOTIFICATION 结构的内存。 通过调用实用工具函数 ScCopyNotifications 复制 NOTIFICATION 结构,以利用其成员中的信息。

另请参阅

IMAPISupport::Subscribe

IMAPISupport::Unsubscribe

通知

ScCopyNotifications

IMsgStore : IMAPIProp