NOTIFCALLBACK

适用于:Outlook 2013 | Outlook 2016

定义 MAPI 调用以发送事件通知的回调函数。 仅当包装在通过调用 HrAllocAdviseSink 函数创建的建议接收器对象中时,才能使用此回调函数。

属性
标头文件:
Mapidefs.h
由实现的已定义函数:
客户端应用程序和服务提供商
由调用的已定义函数:
MAPI
ULONG (STDAPICALLTYPE NOTIFCALLBACK)(
  LPVOID lpvContext,
  ULONG cNotification,
  LPNOTIFICATION lpNotifications
);

参数

lpvContext

[in]指向当 MAPI 调用回调函数时传递给回调函数的任意值的指针。 此值可以表示客户端应用程序或服务提供程序的重要地址。 通常,对于 C++ 代码, lpvContext 参数表示指向 C++ 对象的指针。

cNotification

[in] lpNotifications 参数指示的数组中的事件通知计数。

lpNotifications

[out]指向此函数写入包含事件通知的 NOTIFICATION 结构数组的位置的指针。

返回值

NOTIFCALLBACK 函数原型的有效返回值集取决于函数是由客户端应用程序还是服务提供商实现。 客户端应始终返回S_OK。 提供程序可以返回S_OK或CALLBACK_DISCONTINUE。

备注

CALLBACK_DISCONTINUE仅是同步回调函数的有效返回值;它请求 MAPI 立即停止处理此通知的回调。 返回CALLBACK_DISCONTINUE时,MAPI 将 lpUlFlags 参数设置为从 IMAPISupport::Notify 返回时NOTIFY_CANCELED。

以下是同步回调函数可以执行的操作的限制:

  • 它不能生成另一个同步通知。

  • 它无法显示用户界面。

另请参阅

IMAPIAdviseSink::OnNotify