IMAPIForm::Advise
Gilt für: Outlook 2013 | Outlook 2016
Registriert einen Formular-Viewer für Benachrichtigungen zu Ereignissen, die sich auf das Formular auswirken.
HRESULT Advise(
LPMAPIVIEWADVISESINK pAdvise,
ULONG FAR * pulConnection
);
Parameter
pAdvise
[in] Ein Zeiger auf eine Ansicht empfiehlt dem Senkenobjekt, die nachfolgenden Benachrichtigungen zu empfangen.
pulConnection
[out] Ein Zeiger auf einen Wert ungleich null, der eine erfolgreiche Benachrichtigungsregistrierung darstellt.
Rückgabewert
S_OK
Die Registrierung war erfolgreich.
E_OUTOFMEMORY
Die Registrierung war aufgrund von unzureichendem Arbeitsspeicher nicht erfolgreich.
Hinweise
Formular-Viewer rufen die IMAPIForm::Advise-Methode eines Formulars auf, um sich für Benachrichtigungen zu registrieren, wenn Änderungen am Formular auftreten.
Hinweise für Implementierer
Bewahren Sie eine Kopie des im pAdvise-Parameter übergebenen Ansichts-Empfehlungssenkenzeigers auf, damit Sie ihn verwenden können, um die entsprechende IMAPIViewAdviseSink-Methode aufzurufen, wenn ein Ereignis eintritt. Rufen Sie die IUnknown::AddRef-Methode der Ansicht empfehlungssenke auf, um den Zeiger beizubehalten, bis die Benachrichtigungsregistrierung abgebrochen wird. Legen Sie den Inhalt des pulConnection-Parameters auf eine Zahl ungleich null fest.
Viele Formulare implementieren ein Hilfsobjekt, um die Registrierung und nachfolgende Benachrichtigung von Ereignissen zu verarbeiten.
Weitere Informationen zum Benachrichtigungsprozess im Allgemeinen finden Sie unter Ereignisbenachrichtigung in MAPI.
Weitere Informationen zu Benachrichtigungen und Formularen finden Sie unter Senden und Empfangen von Formularbenachrichtigungen.
Siehe auch
IMAPIViewAdviseSink : IUnknown