HrAllocAdviseSink
适用于:Outlook 2013 | Outlook 2016
创建建议接收器对象,给定由调用实现指定的上下文以及由事件通知触发的回调函数。
属性 | 值 |
---|---|
标头文件: |
Mapiutil.h |
实现者: |
MAPI |
调用者: |
客户端应用程序和服务提供商 |
STDAPI HrAllocAdviseSink(
LPNOTIFCALLBACK lpfnCallback,
LPVOID lpvContext,
LPMAPIADVISESINK FAR * lppAdviseSink
);
参数
lpfnCallback
[in]指向基于 NOTIFCALLBACK 原型的回调函数的指针,当新创建的建议接收器发生通知事件时,MAPI 将调用该原型。
lpvContext
[in]指向 MAPI 调用回调函数时传递给回调函数的调用方数据的指针。 调用方数据可以表示客户端或提供程序的重要地址。 通常,对于 C++ 代码, lpvContext 参数表示指向对象地址的指针。
lppAdviseSink
[out]指向建议接收器对象的指针的指针。
返回值
无。
说明
若要使用 HrAllocAdviseSink 函数,客户端应用程序或服务提供程序会创建一个用于接收通知的对象,根据与该对象一起使用的 NOTIFCALLBACK 函数原型创建通知回调函数,并将指向 HrAllocAdviseSink 函数中的对象的指针作为 lpvContext 值传递。 这样做将执行通知;和 作为通知过程的一部分,MAPI 使用对象指针作为上下文调用回调函数。
MAPI 异步实现其通知引擎。 在 C++ 中,通知回调可以是对象方法。 如果生成通知的对象不存在,请求通知的客户端或提供程序必须为对象的建议接收器保留该对象的单独引用计数。
警告
应谨慎使用 HrAllocAdviseSink;客户创建自己的建议接收器更安全。