CreateOleAdviseHolder-Funktion (ole2.h)

Erstellt ein Empfehlungshalterobjekt für die Verwaltung zusammengesetzter Dokumentbenachrichtigungen. Es gibt einen Zeiger auf die OLE-Implementierung der IOleAdviseHolder-Schnittstelle des Objekts zurück.

Syntax

HRESULT CreateOleAdviseHolder(
  [out] LPOLEADVISEHOLDER *ppOAHolder
);

Parameter

[out] ppOAHolder

Adresse der IOleAdviseHolder-Zeigervariable , die den Schnittstellenzeiger auf das neue Advise Holder-Objekt empfängt.

Rückgabewert

Diese Funktion gibt bei Erfolg S_OK zurück und unterstützt den Standardrückgabewert E_OUTOFMEMORY.

Hinweise

Die Funktion CreateOleAdviseHolder erstellt eine instance eines Beraters, die die OLE-Implementierung der IOleAdviseHolder-Schnittstelle unterstützt. Die Methoden dieser Schnittstelle sollen verwendet werden, um die Beratungsmethoden von IOleObject zu implementieren und, wenn Beratungsverbindungen mit Objekten eingerichtet wurden, die eine Advisory-Senke unterstützen, um Benachrichtigungen über Änderungen im Objekt an die Advisory-Senke zu senden. Der von CreateOleAdviseHolder zurückgegebene Berater reicht für die überwiegende Mehrheit der Anwendungen aus. Die von OLE bereitgestellte Implementierung unterstützt jedoch IOleAdviseHolder::EnumAdvise nicht. Wenn Sie diese Methode verwenden müssen, müssen Sie ihren eigenen Berater implementieren.

Anforderungen

Weitere Informationen

IOleAdviseHolder

IOleObject