IAddrBook::Unadvise
Gilt für: Outlook 2013 | Outlook 2016
Bricht eine Benachrichtigungsregistrierung ab, die zuvor für einen Adressbucheintrag eingerichtet wurde.
HRESULT Unadvise(
ULONG_PTR ulConnection
);
Parameter
ulConnection
[in] Eine Verbindungsnummer, die die registrierung darstellt, die abgebrochen werden soll. Der ulConnection-Parameter sollte einen Wert enthalten, der von einem vorherigen Aufruf der IAddrBook::Advise-Methode zurückgegeben wurde.
Rückgabewert
S_OK
Die Registrierung wurde erfolgreich abgebrochen.
Hinweise
Clients rufen die Unadvise-Methode auf, um den Empfang von Benachrichtigungen über Änderungen an einem bestimmten Adressbucheintrag zu beenden. Wenn eine Benachrichtigungsregistrierung abgebrochen wird, gibt der Adressbuchanbieter seinen Zeiger auf die Empfehlungssenke des Anrufers frei. Das Release kann jedoch während des Unadvise-Aufrufs oder zu einem späteren Zeitpunkt auftreten, wenn ein anderer Thread gerade die IMAPIAdviseSink::OnNotify-Methode aufruft. Wenn eine Benachrichtigung ausgeführt wird, wird das Release verzögert, bis die OnNotify-Methode zurückgegeben wird.