IEnumShellItems ::Next, méthode (shobjidl_core.h)

Article
03/02/2024

Obtient un tableau d’une ou plusieurs interfaces IShellItem de l’énumération.

Syntaxe

HRESULT Next(
  [in]  ULONG      celt,
  [out] IShellItem **rgelt,
  [out] ULONG      *pceltFetched
);

Paramètres

[in] celt

Type : ULONG

Nombre d’éléments dans le tableau référencés par le paramètre rgelt .

[out] rgelt

Type : IShellItem**

Adresse d’un tableau de pointeurs vers les interfaces IShellItem qui reçoivent le ou les éléments énumérés. L’application appelante est chargée de libérer les interfaces IShellItem en appelant la méthode IUnknown ::Release .

[out] pceltFetched

Type : ULONG*

Pointeur vers une valeur qui reçoit le nombre d’interfaces IShellItem récupérées avec succès. Le nombre peut être inférieur à la valeur spécifiée dans le paramètre celt . Ce paramètre peut avoir la valeur NULL à l’entrée uniquement si celt est un, car dans ce cas, la méthode ne peut récupérer qu’un seul élément et retourner S_OK, ou zéro élément et renvoyer S_FALSE.

Valeur retournée

Type : HRESULT

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	si au moins l’interface IShellItem a été récupérée.
S_FALSE	s’il n’y a plus d’interfaces IShellItem dans l’énumération.
	Retourne une valeur d’erreur si la fonction échoue pour toute autre raison.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)

Voir aussi

IEnumShellItems

IShellItem

Partager via