CreateOleAdviseHolder, fonction (ole2.h)
Crée un objet de titulaire d’avis pour la gestion des notifications de documents composés. Il retourne un pointeur vers l’implémentation OLE de l’objet de l’interface IOleAdviseHolder .
Syntaxe
HRESULT CreateOleAdviseHolder(
[out] LPOLEADVISEHOLDER *ppOAHolder
);
Paramètres
[out] ppOAHolder
Adresse de la variable de pointeur IOleAdviseHolder qui reçoit le pointeur d’interface vers le nouvel objet de titulaire de conseil.
Valeur retournée
Cette fonction retourne S_OK en cas de réussite et prend en charge la valeur de retour standard E_OUTOFMEMORY.
Remarques
La fonction CreateOleAdviseHolder crée un instance d’un titulaire d’avis, qui prend en charge l’implémentation OLE de l’interface IOleAdviseHolder. Les méthodes de cette interface sont destinées à être utilisées pour implémenter les méthodes de conseil d’IOleObject et, lorsque des connexions de conseil ont été configurées avec des objets prenant en charge un récepteur de conseil, pour envoyer des notifications de modifications de l’objet au récepteur de conseil. Le titulaire d’avis retourné par CreateOleAdviseHolder suffit pour la grande majorité des applications. L’implémentation fournie par OLE ne prend pas en charge IOleAdviseHolder ::EnumAdvise. Par conséquent, si vous devez utiliser cette méthode, vous devez implémenter votre propre titulaire de conseils.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | ole2.h |
| Bibliothèque | Ole32.lib |
| DLL | Ole32.dll |
| Ensemble d’API | ext-ms-win-com-ole32-l1-1-3 (introduit dans Windows 10, version 10.0.10240) |