IMAPIViewContext::SetAdviseSink
The IMAPIViewContext::SetAdviseSink
method registers a form for notifications about changes to a view s status.
Quick Info
See IMAPIViewContext
: IUnknown.
HRESULT SetAdviseSink(
|
LPMAPIFORMADVISESINK pmvns |
|
|
) |
|
Parameters
pmvns
[in] Pointer
to a form advise sink object.
Return Value
S_OK
The call
succeeded.
Remarks
Form objects
call the IMAPIViewContext::SetNotifySink method to
register for notification about changes to which message is next or previous
within a particular view context. When called with NULL in the pmvns
parameter, SetNotifySink cancels a previous registration for
notification.
Notes to Implementers
The client
application s implementation of IMAPIViewContext::SetAdviseSink needs to add the form
object s advise sink to the client application s advising mechanism. Typically
this just means remembering the LPMAPIFORMADVISESINK pointer so that the client
application can call the form object s IMAPIFormAdviseSink:IUnknown methods as appropriate.
For more
information about implementing the interfaces related to form servers, see MAPI
Form Interfaces Used by Client Applications.