Platform SDK: MAPI

IAddrBook::Unadvise

The IAddrBook::Unadvise method cancels a notification registration previously established for an address book entry.

Quick Info

See IAddrBook : IMAPIProp.

HRESULT Unadvise(
  ULONG ulConnection  
);
 

Parameters

ulConnection
[in] Connection number that represents the registration to be canceled. The ulConnection parameter should contain a value returned by a prior call to IAddrBook::Advise.

Return Values

S_OK
The registration was successfully canceled.

Remarks

Clients call the IAddrBook::Unadvise method to stop receiving notifications about changes to a particular address book entry. When a notification registration is canceled, the address book provider releases its pointer to the caller's advise sink. However, the release can occur during the Unadvise call or at some later point, if another thread is in the process of calling IMAPIAdviseSink::OnNotify. When a notification is in progress, the release is delayed until the OnNotify method returns.

See Also

IAddrBook::Advise, IMAPIAdviseSink::OnNotify