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 结构,以利用其成员中的信息。