Share via

IMsgStore::Unadvise

  • Article

4/8/2010

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

Syntax

HRESULT Unadvise (
  ULONG ulConnection
);

Parameters

  • ulConnection
    [in] The 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 IMsgStore::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 cancels a registration for notification. Unadvise releases its pointer to the caller's advise sink, which it received in the IMsgStore::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 mapidefs.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

IMAPIAdviseSink::OnNotify
IMsgStore
IMsgStore::Advise

Other Resources

Messaging