IMSLogon::Unadvise

Applies to: Outlook 2013 | Outlook 2016

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.

See also

IMAPIAdviseSink::OnNotify

IMSLogon::Advise

IMSLogon : IUnknown