IOleObject ::EnumAdvise, méthode (oleidl.h)

Récupère un pointeur vers un énumérateur qui peut être utilisé pour énumérer les connexions d’avis inscrites pour un objet, afin qu’un conteneur puisse savoir quoi libérer avant de se fermer.

Syntaxe

HRESULT EnumAdvise(
  [out] IEnumSTATDATA **ppenumAdvise
);

Paramètres

[out] ppenumAdvise

Adresse de la variable pointeur IEnumSTATDATA qui reçoit le pointeur d’interface vers l’objet énumérateur. Si l’objet n’a pas de connexions de conseil ou si une erreur se produit, l’implémentation doit définir ppenumAdvise sur NULL. Chaque fois qu’un objet reçoit un appel réussi à IOleObject ::EnumAdvise, il doit augmenter le nombre de références sur ppenumAdvise. Il est de la responsabilité de l’appelant d’appeler Release lorsqu’il est terminé avec le ppenumAdvise.

Valeur retournée

Cette méthode retourne S_OK en cas de réussite. Les autres valeurs de retour possibles sont les suivantes.

Remarques

La méthode IOleObject ::EnumAdvise fournit un énumérateur qui permet aux conteneurs de suivre les connexions de conseil inscrites pour leurs objets. Un conteneur appelle normalement cette fonction afin qu’il puisse demander à un objet de libérer chacune de ses connexions de conseil avant de se fermer.

L’énumérateur auquel vous avez accès via IOleObject ::EnumAdvise énumère les éléments de type STATDATA. Lors de la réception du pointeur, le conteneur peut ensuite parcourir STATDATA et appeler IOleObject ::Unadvise pour chaque connexion énumérée.

La méthode habituelle pour implémenter cette fonction consiste à déléguer l’appel à l’interface IOleAdviseHolder . Seuls les membres pAdvise et dwConnection de STATDATA sont pertinents pour IOleObject ::EnumAdvise.

Configuration requise

Voir aussi

IOleObject

IOleObject ::Advise

IOleObject ::Unadvise