Méthode IDataObject ::EnumDAdvise (objidl.h)

Crée un objet qui peut être utilisé pour énumérer les connexions de notifications actuelles.

Syntaxe

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

Paramètres

[out] ppenumAdvise

Pointeur vers une variable de pointeur IEnumSTATDATA qui reçoit le pointeur d’interface vers le nouvel objet énumérateur. Si l’implémentation définit *ppenumAdvise sur NULL, il n’existe aucune connexion à conseiller aux récepteurs pour l’instant.

Valeur retournée

Cette méthode retourne S_OK si l’objet énumérateur est correctement instancié ou s’il n’existe aucune connexion. Les autres valeurs possibles sont les suivantes.

Code de retour Description
E_OUTOFMEMORY
La mémoire disponible pour l’opération est insuffisante.
OLE_E_ADVISENOTSUPPORTED
Les notifications d’avis ne sont pas prises en charge par cet objet.

Remarques

L’objet énumérateur créé par cette méthode implémente l’interface IEnumSTATDATA . IEnumSTATDATA autorise l’énumération des données stockées dans un tableau de structures STATDATA . Chacune de ces structures fournit des informations sur une seule connexion de conseil et inclut des informations FORMATETC et ADVF , ainsi que le pointeur vers le récepteur de conseil et le jeton représentant la connexion.

Remarques aux appelants

Il est recommandé d’utiliser l’objet ole data advise holder pour gérer les connexions de conseil. Avec le pointeur obtenu via un appel à CreateDataAdviseHolder, l’implémentation de IDataObject ::EnumDAdvise devient une simple question de délégation de l’appel à IDataAdviseHolder ::EnumAdvise. Cela crée l’énumérateur et fournit le pointeur vers l’implémentation OLE de IEnumSTATDATA. À ce stade, vous pouvez appeler ses méthodes pour énumérer les connexions de conseil actuelles.

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 objidl.h

Voir aussi

IDataAdviseHolder ::EnumAdvise

Idataobject

IEnumSTATDATA