Share via

IMAPISession::Unadvise (Compact 7)

  • Article

3/12/2014

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 lpulConnectionparameter 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

See Also

Reference

IMAPISession
IMAPIAdviseSink::OnNotify
IMAPISession::Advise