IWiaItem::EnumChildItems, méthode (wia_xp.h)

La méthode IWiaItem::EnumChildItems crée un objet énumérateur et renvoie un pointeur vers son interface IEnumWiaItem pour les dossiers non vides dans une arborescence IWiaItem d’un appareil d’acquisition d’images Windows (WIA).

Syntaxe

HRESULT EnumChildItems(
  [out] IEnumWiaItem **ppIEnumWiaItem
);

Paramètres

[out] ppIEnumWiaItem

Type : IEnumWiaItem**

Reçoit l’adresse d’un pointeur vers l’interface IEnumWiaItem créée par IWiaItem::EnumChildItems .

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Le système d’exécution WIA représente chaque appareil matériel WIA sous la forme d’une arborescence hiérarchique d’objets IWiaItem . La méthode IWiaItem::EnumChildItems permet aux applications d’énumérer les éléments enfants dans l’élément actif. Toutefois, elle ne peut être appliquée qu’aux éléments qui sont des dossiers.

Si le dossier n’est pas vide, il contient une sous-arborescence d’objets IWiaItem . La méthode IWiaItem::EnumChildItems énumère tous les éléments contenus dans le dossier. Il stocke un pointeur vers un énumérateur dans le paramètre ppIEnumWiaItem . Les applications utilisent le pointeur d’énumérateur pour effectuer l’énumération des éléments enfants d’un objet.

Les applications doivent appeler la méthode IUnknown::Release sur les pointeurs d’interface qu’elles reçoivent via le paramètre ppIEnumWiaItem .

Configuration requise