Método IEnumShellItems::Next (shobjidl_core.h)

Obtiene una matriz de una o varias interfaces IShellItem de la enumeración.

Sintaxis

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

Parámetros

[in] celt

Tipo: ULONG

Número de elementos de la matriz a los que hace referencia el parámetro rgelt .

[out] rgelt

Tipo: IShellItem**

Dirección de una matriz de punteros a interfaces IShellItem que reciben el elemento o elementos enumerados. La aplicación que realiza la llamada es responsable de liberar las interfaces IShellItem mediante una llamada al método IUnknown::Release .

[out] pceltFetched

Tipo: ULONG*

Puntero a un valor que recibe el número de interfaces IShellItem recuperadas correctamente. El recuento puede ser menor que el valor especificado en el parámetro celt . Este parámetro solo puede ser NULL en la entrada si celt es uno, porque en ese caso el método solo puede recuperar un elemento y devolver S_OK, o cero elementos y devolver S_FALSE.

Valor devuelto

Tipo: HRESULT

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	si se recuperó al menos la interfaz IShellItem .
S_FALSE	si no hay más interfaces IShellItem en la enumeración.
	Devuelve un valor de error si se produce un error en la función por cualquier otro motivo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (incluya Shobjidl.h)

Consulte también

IEnumShellItems

IShellItem