IMsgStore::Unadvise

Article
08/28/2006

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 Values

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

Pocket PC: Pocket PC 2002 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: mapidefs.h
Library: cemapi.lib