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 |
|---|---|
|
La mémoire disponible pour l’opération est insuffisante. |
|
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 |