IMSLogon::Unadvise

The IMSLogon::Unadvise method removes an object s registration for notification of message store changes previously established with a call to the IMSLogon::Advise1GRNZO7 method.

Quick Info

See IMSLogon : IUnknown44MX9W.

 

HRESULT Unadvise(

    ULONG ulConnection

 

   )

 

 

Parameters

ulConnection

[in] Number of the registration connection returned by a call to IMSLogon::Advise1GRNZO7.

 

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, but if another thread is in the process of calling the IMAPIAdviseSink::OnNotify5WYI5X method for the advise sink object, the Release call is delayed until the OnNotify method returns.

See Also

IMAPIAdviseSink::OnNotify, IMSLogon::Advise