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

Article
03/01/2024

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.

Code de retour	Description
E_FAIL	L’opération d’énumération a échoué.
E_NOTIMPL	IOleAdviseHolder ::EnumAdvise n’est pas implémenté.

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

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