Platform SDK: MAPI |
The IMAPIForm::Advise method registers a form viewer for notifications about events affecting the form.
See IMAPIForm : IUnknown.
HRESULT Advise( LPMAPIVIEWADVISESINK pAdvise, ULONG FAR * pulConnection );
Form viewers call a form's IMAPIForm::Advise method to register for notification when changes occur to the form.
Keep a copy of the view advise sink pointer passed in the pAdvise parameter so that you can use it to call the appropriate IMAPIViewAdviseSink method when an event occurs. Call the view advise sink's IUnknown::AddRef method to retain the pointer until notification registration is canceled. Set the contents of the pulConnection parameter to a nonzero number.
Many forms implement a helper object to handle the registration and subsequent notification of events.
For more information on the notification process in general, see Event Notification in MAPI.
For more information about notification and forms, see Sending and Receiving Form Notifications.