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
| 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) |