IOleContainer ::EnumObjects, méthode (oleidl.h)

Article
03/06/2024

Énumère les objets dans le conteneur actuel.

Syntaxe

HRESULT EnumObjects(
  [in]  DWORD        grfFlags,
  [out] IEnumUnknown **ppenum
);

Paramètres

[in] grfFlags

Spécifie les objets d’un conteneur à énumérer, tels que définis dans l’énumération OLECONTF.

[out] ppenum

Pointeur vers une variable de pointeur IEnumUnknown qui reçoit le pointeur d’interface vers l’objet énumérateur. Chaque fois qu’un conteneur reçoit un appel réussi à EnumObjects, il doit augmenter le nombre de références sur le pointeur ppenum que la méthode retourne. Il incombe à l’appelant d’appeler IUnknown ::Release lorsque vous avez terminé avec le pointeur. Si une erreur est retournée, l’implémentation doit définir ppenum sur NULL.

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 a échoué.
E_NOTIMPL	Énumération d’objet non prise en charge.

Remarques

Un conteneur doit implémenter EnumObjects pour permettre aux clients programmatiques de déterminer les objets qu’il contient. Toutefois, cette méthode n’est pas appelée dans les scénarios de liaison standard.

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

Voir aussi

Partager via