Compartir a través de

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

  • Artículo

Recupera un número especificado de IDLIST_ABSOLUTE elementos.

Sintaxis

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

Parámetros

[in] celt

Tipo: ULONG

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

[out] rgelt

Tipo: PIDLIST_ABSOLUTE*

Si se ejecuta correctamente, contiene una matriz PIDL. La implementación debe asignar estos identificadores de elemento mediante CoTaskMemAlloc. La aplicación que realiza la llamada es responsable de liberar los identificadores de elemento mediante CoTaskMemFree.

[out] pceltFetched

Tipo: ULONG*

Si se ejecuta correctamente, contiene un puntero a un valor que recibe un recuento de los identificadores absolutos de elemento devueltos realmente en rgelt. 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 1, porque en ese caso el método solo puede recuperar uno (S_OK) o cero (S_FALSE).

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si el método recuperó correctamente los elementos celt solicitados . Este método solo devuelve S_OK si el recuento completo de elementos solicitados se recupera correctamente.

S_FALSE indica que se solicitaron más elementos que en la enumeración. El valor al que apunta el parámetro pceltFetched especifica el número real de elementos recuperados. Tenga en cuenta que el valor será 0 si no hay más elementos que recuperar.

Devuelve un valor de error definido por COM; de lo contrario, devuelve un valor de error definido por COM.

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)