Méthode IOleAdviseHolder ::EnumAdvise (oleidl.h)

Crée un énumérateur qui peut être utilisé pour énumérer les connexions de conseil actuellement établies pour un objet.

Syntaxe

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

Paramètres

[out] ppenumAdvise

Pointeur vers une variable de pointeur IEnumSTATDATA qui reçoit le pointeur d’interface vers le nouvel énumérateur. Si ce paramètre a la valeur NULL, il n’y a actuellement aucune connexion de conseil sur l’objet, ou une erreur s’est produite. Le titulaire du conseil est responsable de l’incrémentation du nombre de références sur le pointeur IEnumSTATDATA que cette méthode fournit. Il incombe à l’appelant d’appeler IUnknown ::Release lorsqu’il a terminé avec le pointeur.

Valeur retournée

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

Remarques

IOleAdviseHolder ::EnumAdvise crée un énumérateur qui peut être utilisé pour énumérer les connexions de conseil établies d’un objet. La méthode fournit un pointeur vers l’interface IEnumSTATDATA sur cet énumérateur. Les informations de connexion de conseil pour chaque connexion sont stockées dans la structure STATDATA , et l’énumérateur doit être en mesure d’énumérer ces structures.

Pour cette méthode, les seuls membres de structure pertinents sont pAdvise et dwConnection. Les autres membres contiennent des informations de conseil sur les données. Lorsque vous appelez les méthodes d’énumération et qu’une énumération est en cours, l’effet de l’inscription ou de la révocation de connexions de conseil sur ce qui doit être énuméré n’est pas défini.

Configuration requise

Voir aussi

IDataAdviseHolder ::EnumAdvise

IOleAdviseHolder

IOleAdviseHolder ::Advise

IOleAdviseHolder ::Unadvise

IOleObject ::EnumAdvise

STATDATA