IMAPISession::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 the sending of notifications previously set up with a call to the IMAPISession::Advise method.
HRESULT Unadvise(
ULONG ulConnection
);
Parameters
- ulConnection
[in] A connection number associated with an active notification registration. The value of ulConnection must have been returned by a previous call to IMAPISession::Advise.
Return Value
- S_OK
The registration was successfully canceled.
Remarks
The IMAPISession::Unadvise method cancels a registration for notification. Unadvise releases its pointer to the caller's advise sink, which it received in the Advise call used for registration.
Generally, Unadvise calls the advise sink's IUnknown::Release method during the Unadvise call. However, if another thread is in the process of calling the advise sink's IMAPIAdviseSink::OnNotify method, the Release call is delayed until the OnNotify method returns.