IMAPIForm::Advise
适用于:Outlook 2013 | Outlook 2016
注册表单查看器,以获取有关影响窗体的事件的通知。
HRESULT Advise(
LPMAPIVIEWADVISESINK pAdvise,
ULONG FAR * pulConnection
);
参数
pAdvise
[in]指向视图的指针建议接收器对象接收后续通知。
pulConnection
[out]指向表示成功通知注册的非零值的指针。
返回值
S_OK
注册成功。
E_OUTOFMEMORY
由于内存不足,注册失败。
备注
表单查看者调用窗体的 IMAPIForm::Advise 方法,以便在窗体发生更改时注册通知。
针对实现者的说明
保留 pAdvise 参数中传递的视图建议接收器指针的副本,以便在事件发生时使用它调用相应的 IMAPIViewAdviseSink 方法。 调用视图建议接收器的 IUnknown::AddRef 方法以保留指针,直到取消通知注册。 将 pulConnection 参数的内容设置为非零数。
许多表单实现帮助程序对象来处理事件的注册和后续通知。
有关一般通知过程的详细信息,请参阅 MAPI 中的事件通知。
有关通知和表单的详细信息,请参阅 发送和接收表单通知。