IMAPISession::Unadvise
4/8/2010
The Unadvise method cancels the sending of notifications previously set up with a call to the IMAPISession::Advise method.
Syntax
HRESULT Unadvise (
ULONG ulConnection
);
Parameters
- ulConnection
[in] Connection number associated with an active notification registration. The value of ulConnection must be a value referenced by the lpulConnection parameter from a previous call to IMAPISession::Advise.
Return Value
This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:
- S_OK
Indicates success.
Remarks
Unadvise releases its pointer to the caller's advise sink, which it received in the IMAPISession::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::OnNotify method, the Release call is delayed until OnNotify returns.
Requirements
| Header | mapix.h |
| Library | cemapi.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Pocket PC 2002 and later, Smartphone 2002 and later |
See Also
Reference
IMAPISession
IMAPIAdviseSink::OnNotify
IMAPISession::Advise