Share via

IMAPISession::Unadvise

  • Article

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

Other Resources

Messaging