IEnumWiaItem ::Next, méthode (wia_xp.h)

La méthode IEnumWiaItem ::Next remplit un tableau de pointeurs vers les interfaces IWiaItem .

Syntaxe

HRESULT Next(
  [in]      ULONG    celt,
  [out]     IWiaItem **ppIWiaItem,
  [in, out] ULONG    *pceltFetched
);

Paramètres

[in] celt

Type : ULONG

Spécifie le nombre d’éléments de tableau dans le tableau indiqué par le paramètre ppIWiaItem .

[out] ppIWiaItem

Type : IWiaItem**

Reçoit l’adresse d’un tableau de pointeurs d’interface IWiaItem . IEnumWiaItem ::Next remplit ce tableau avec des pointeurs d’interface.

[in, out] pceltFetched

Type : ULONG*

À la sortie, ce paramètre reçoit le nombre de pointeurs d’interface réellement stockés dans le tableau indiqué par le paramètre ppIWiaItem . Une fois l’énumération terminée, ce paramètre contient zéro.

Valeur retournée

Type : HRESULT

Si la méthode réussit, la méthode retourne S_OK. Une fois l’énumération terminée, elle retourne S_FALSE. Si la méthode échoue, elle retourne un code d’erreur COM standard.

Remarques

Le système d’exécution d’acquisition d’images Windows (WIA) représente les périphériques matériels WIA comme une arborescence hiérarchique d’objets IWiaItem . Les applications utilisent la méthode IEnumWiaItem ::Next pour obtenir un pointeur d’interface IWiaItem pour chaque élément du dossier actif de l’arborescence d’objets IWiaItem d’un périphérique matériel.

Pour obtenir la liste des pointeurs, l’application transmet un tableau de pointeurs d’interface IWiaItem qu’elle alloue. Il transmet également le nombre d’éléments de tableau dans le paramètre celt . La méthode IEnumWiaItem ::Next remplit le tableau avec des pointeurs vers les interfaces IWiaItem .

Tant que le processus d’énumération n’est pas terminé, la méthode IEnumWiaItem ::Next retourne S_OK. Chaque fois qu’il le fait, il définit la valeur pointée par pceltFetched sur le nombre d’éléments qu’il a insérés dans le tableau. Lorsque IEnumWiaItem ::Next termine le processus d’énumération des objets IWiaItem , il retourne S_FALSE et définit l’emplacement de mémoire vers lequel pceltFetched pointe sur zéro.

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

Configuration requise