IMSLogon::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.
Removes an object's registration for notification of message store changes previously established by using a call to the IMSLogon::Advise method.
HRESULT Unadvise(
ULONG ulConnection
);
Parameters
- ulConnection
[in] The number of the registration connection returned by a call to IMSLogon::Advise.
Return Value
- S_OK
The call succeeded and has returned the expected value or values.
Remarks
Message store providers implement the IMSLogon::Unadvise method to release the pointer to the advise sink object passed in the lpAdviseSink parameter in the previous call to IMSLogon::Advise, thereby canceling a notification registration. As part of discarding the pointer to the advise sink object, the object's IUnknown::Release method is called. Generally, Release is called during the Unadvise call. However, if another thread is in the process of calling the IMAPIAdviseSink::OnNotify method for the advise sink object, the Release call is delayed until the OnNotify method returns.