CreateOleAdviseHolder-Funktion (ole2.h)

  • Artikel

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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ole2.h
Bibliothek Ole32.lib
DLL Ole32.dll
APIs ext-ms-win-com-ole32-l1-1-3 (eingeführt in Windows 10, Version 10.0.10240)

Weitere Informationen

IOleAdviseHolder

IOleObject