IABLogon::Unadvise
This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
Cancels notifications that were previously set up with a call to the IABLogon::Advise method.
HRESULT Unadvise(
ULONG ulConnection
);
Parameters
- ulConnection
[in] The connection number associated with an active notification registration. A previous call to Advise must have returned the value of ulConnection.
Return Value
- S_OK
The notification registration was successfully canceled.
Remarks
MAPI calls the Unadvise method to cancel a notification registration for a container, messaging user, or distribution list object.
Notes to Implementers
Your implementation of Unadvise will depend on whether you support notification with MAPI's help or manually. If MAPI provides your support, call the IMAPISupport::Unsubscribe method to cancel the registration. If another thread is in the process of calling the advise sink's IMAPIAdviseSink::OnNotify method, it can be delayed until OnNotify has returned.
For more information about the notification process, see Event Notification in MAPI. For information about how to use the IMAPISupport : IUnknown methods to support notification, see Supporting Event Notification.