IMsgStore::Unadvise
Applies to: Office 2010 | Outlook 2010 | Visual Studio
Cancels the sending of notifications previously set up with a call to the IMsgStore::Advise method.
HRESULT Unadvise(
ULONG_PTR ulConnection
);
Parameters
- ulConnection
[in] The connection number associated with an active notification registration. The value of ulConnection must have been returned by a previous call to the IMsgStore::Advise method.
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. 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.