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)

Voir aussi

IOleAdviseHolder

IOleObject