IMsgStore::Unadvise

The IMsgStore::Unadvise method cancels the sending of notifications previously set up with a call to the IMsgStore::AdviseOVA.7 method.

Quick Info

See IMsgStore : IMAPIProp9A02HD.

 

HRESULT Unadvise(

    ULONG ulConnection

 

   )

 

 

Parameters

ulConnection

[in] Connection number associated with an active notification registration. The value of ulConnection must have been returned by a previous call to IMsgStore::AdviseOVA.7.

 

Return Value

S_OK

The registration was successfully canceled.

 

Remarks

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

See Also

IMAPIAdviseSink::OnNotify, IMsgStore::Advise