Partager via

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

  • Article

Récupère un nombre spécifié d’éléments IDLIST_ABSOLUTE.

Syntaxe

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

Paramètres

[in] celt

Type : ULONG

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

[out] rgelt

Type : PIDLIST_ABSOLUTE*

En cas de réussite, contient un tableau PIDL. L’implémentation doit allouer ces identificateurs d’élément à l’aide de CoTaskMemAlloc. L’application appelante est chargée de libérer les identificateurs d’élément à l’aide de CoTaskMemFree.

[out] pceltFetched

Type : ULONG*

En cas de réussite, contient un pointeur vers une valeur qui reçoit le nombre d’identificateurs d’élément absolus retournés dans rgelt. Le nombre peut être inférieur à la valeur spécifiée dans le paramètre celt . Ce paramètre peut être NULL à l’entrée uniquement si celte a la valeur 1, car dans ce cas, la méthode ne peut récupérer qu’un (S_OK) ou zéro (S_FALSE).

Valeur retournée

Type : HRESULT

Retourne S_OK si la méthode a correctement récupéré les éléments celtes demandés. Cette méthode retourne S_OK uniquement si le nombre total d’éléments demandés est récupéré avec succès.

S_FALSE indique que plus d’éléments ont été demandés qu’il n’en reste dans l’énumération. La valeur pointée par le paramètre pceltFetched spécifie le nombre réel d’éléments récupérés. Notez que la valeur sera 0 s’il n’y a plus d’éléments à récupérer.

Retourne une valeur d’erreur définie par COM dans le cas contraire.

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)