Freigeben über


IMAPIViewContext::SetAdviseSink

Gilt für: Outlook 2013 | Outlook 2016

Verwaltet die Registrierung eines Formulars, um Benachrichtigungen zu Änderungen im Viewer zu erhalten.

HRESULT SetAdviseSink(
LPMAPIFORMADVISESINK pmvns
);

Parameter

pmvns

[in] Zeiger auf ein Formular mit Empfehlungssenkenobjekt oder NULL.

Rückgabewert

S_OK

Die Registrierung oder Kündigung der Formularbenachrichtigung war erfolgreich.

Hinweise

Formularobjekte rufen die IMAPIViewContext::SetAdviseSink-Methode auf, um sich entweder zu registrieren, um mehr über Änderungen im Formular-Viewer zu erfahren, oder um eine vorherige Registrierung abzubrechen. Wenn pmvns auf NULL festgelegt ist, möchte das Formular eine Registrierung abbrechen. Wenn pmvns auf eine gültige Formularhinweissenke verweist, möchte das Formular für zukünftige Benachrichtigungen registriert werden.

Hinweise für Implementierer

Wenn SetAdviseSink einen Formularhinweissenkenzeiger enthält, behalten Sie einen Verweis darauf bei, bis ein anderer SetAdviseSink-Aufruf zum Abbrechen der Benachrichtigung erfolgt. Senden Sie eine Benachrichtigung, wenn eine Änderung in Ihrem Viewer auftritt und Wenn Sie eine neue Nachricht laden.

Weitere Informationen finden Sie unter Senden und Empfangen von Formularbenachrichtigungen.

MFCMAPI-Referenz

Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.

Datei Funktion Kommentar
MyMAPIFormViewer.cpp
CMyMAPIFormViewer::SetAdviseSink
MFCMAPI implementiert die IMAPIViewContext::SetAdviseSink-Methode in dieser Funktion.

Siehe auch

MFCMAPI (engl.) als ein Codebeispiel