HrAllocAdviseSink

Gilt für: Outlook 2013 | Outlook 2016

Erstellt ein Empfehlungssenkenobjekt unter Berücksichtigung eines durch die aufrufenden Implementierung angegebenen Kontexts und einer Rückruffunktion, die von einer Ereignisbenachrichtigung ausgelöst werden soll.

STDAPI HrAllocAdviseSink(
  LPNOTIFCALLBACK lpfnCallback,
  LPVOID lpvContext,
  LPMAPIADVISESINK FAR * lppAdviseSink
);

Parameter

lpfnCallback

[in] Zeiger auf eine Rückruffunktion, die auf dem NOTIFCALLBACK-Prototyp basiert, den MAPI aufrufen soll, wenn ein Benachrichtigungsereignis für die neu erstellte Empfehlungssenke auftritt.

lpvContext

[in] Zeiger auf Aufruferdaten, die an die Rückruffunktion übergeben werden, wenn MAPI sie aufruft. Die Aufruferdaten können eine Adresse darstellen, die für den Client oder Anbieter von Bedeutung ist. In der Regel stellt der Parameter lpvContext für C++-Code einen Zeiger auf die Adresse eines Objekts dar.

lppAdviseSink

[out] Zeiger auf einen Zeiger auf ein Beratungssenkenobjekt.

Rückgabewert

None.

Hinweise

Um die HrAllocAdviseSink-Funktion zu verwenden, erstellt eine Clientanwendung oder ein Dienstanbieter ein Objekt zum Empfangen von Benachrichtigungen, erstellt eine Benachrichtigungsrückruffunktion basierend auf dem Prototyp der FUNKTION NOTIFCALLBACK , der zu diesem Objekt gehört, und übergibt einen Zeiger auf das Objekt in der HrAllocAdviseSink-Funktion als lpvContext-Wert . Dadurch wird eine Benachrichtigung ausgeführt; und im Rahmen des Benachrichtigungsprozesses ruft MAPI die Rückruffunktion mit dem Objektzeiger als Kontext auf.

MAPI implementiert seine Benachrichtigungs-Engine asynchron. In C++ kann der Benachrichtigungsrückruf eine Objektmethode sein. Wenn das Objekt, das die Benachrichtigung generiert, nicht vorhanden ist, muss der Client oder Anbieter, der eine Benachrichtigung anfordert, eine separate Verweisanzahl für dieses Objekt für die Empfehlungssenke des Objekts beibehalten.