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