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 中的事件通知

有关通知和表单的详细信息,请参阅 发送和接收表单通知

另请参阅

IMAPIForm::Unadvise

IMAPIViewAdviseSink : IUnknown

IMAPIForm : IUnknown

MAPI 中的事件通知

发送和接收表单通知