IMAPISupport::Unsubscribe
Gilt für: Outlook 2013 | Outlook 2016
Hebt die Verantwortung für das Senden von Benachrichtigungen auf, die zuvor mit einem Aufruf der IMAPISupport::Subscribe-Methode eingerichtet wurden.
HRESULT Unsubscribe(
ULONG ulConnection
);
Parameter
ulConnection
[in] Die Verbindungsnummer ungleich null, die die Benachrichtigungsregistrierung darstellt, die zuvor über IMAPISupport::Subscribe eingerichtet wurde.
Rückgabewert
S_OK
Die Benachrichtigungsregistrierung wurde abgebrochen.
MAPI_E_NOT_FOUND
Die im ulConnection-Parameter übergebene Verbindungsnummer ist nicht vorhanden.
Hinweise
Die IMAPISupport::Unsubscribe-Methode wird für alle Dienstanbieter-Supportobjekte implementiert. Dienstanbieter rufen "Unsubscribe" auf, um eine Benachrichtigungsregistrierung abzubrechen, die zuvor von Subscribe eingerichtet wurde. Das Abonnement bricht die Registrierung ab, indem der im Abonnementaufruf übergebene Zeiger für die Empfehlungssenke freigegeben wird.
Im Allgemeinen wird die IUnknown::Release-Methode der Empfehlungssenke während des Unsubscribe-Aufrufs aufgerufen. Wenn jedoch gerade ein anderer Thread die IMAPIAdviseSink::OnNotify-Methode für das Objekt der Empfehlungssenke aufruft, wird der Release-Aufruf verzögert, bis die OnNotify-Methode zurückgegeben wird.