IWiaItem2::EnumChildItems, méthode

Crée un objet énumérateur et transmet un pointeur vers son interface IEnumWiaItem2 pour les dossiers avec des éléments dans l’arborescence IWiaItem2 d’un appareil d’acquisition d’images Windows (WIA) 2.0.

Syntaxe

HRESULT EnumChildItems(
  [in]  const GUID          *pCategoryGUID,
  [out]       IEnumWiaItem2 **ppIEnumWiaItem2
);

Paramètres

pCategoryGUID [in]

Type : const GUID*

Spécifie un pointeur vers une catégorie pour laquelle les nœuds enfants sont énumérés. Si la valeur est NULL, tous les nœuds enfants sont énumérés.

ppIEnumWiaItem2 [out]

Type : IEnumWiaItem2**

Reçoit l’adresse d’un pointeur vers l’interface IEnumWiaItem2 que cette méthode crée.

Valeur retournée

Type : HRESULT

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

Notes

Le système d’exécution WIA 2.0 représente chaque appareil matériel WIA 2.0 en tant qu’arborescence hiérarchique d’objets IWiaItem2 . La méthode IWiaItem2::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 IWiaItem2 . La méthode IWiaItem2::EnumChildItems énumère tous les éléments contenus dans le dossier. Il stocke un pointeur vers un énumérateur dans le paramètre ppIEnumWiaItem2 . 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 ppIEnumWiaItem2 .

Spécifications