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

Recupera um número especificado de itens de IDLIST_ABSOLUTE.

Sintaxe

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

Parâmetros

[in] celt

Tipo: ULONG

O número de itens referenciados na matriz referenciada pelo parâmetro rgelt .

[out] rgelt

Tipo: PIDLIST_ABSOLUTE*

Em caso de êxito, contém uma matriz PIDL. A implementação deve alocar esses identificadores de item usando CoTaskMemAlloc. O aplicativo de chamada é responsável por liberar os identificadores de item usando CoTaskMemFree.

[out] pceltFetched

Tipo: ULONG*

Em caso de êxito, contém um ponteiro para um valor que recebe uma contagem dos identificadores absolutos de item realmente retornados no rgelt. A contagem pode ser menor do que o valor especificado no parâmetro celt . Esse parâmetro só poderá ser NULL na entrada se o celt for 1, pois nesse caso o método só pode recuperar um (S_OK) ou zero (S_FALSE).

Retornar valor

Tipo: HRESULT

Retorna S_OK se o método recuperou com êxito os elementos celt solicitados. Esse método só retornará S_OK se a contagem completa de itens solicitados for recuperada com êxito.

S_FALSE indica que mais itens foram solicitados do que permaneceram na enumeração. O valor apontado pelo parâmetro pceltFetched especifica o número real de itens recuperados. Observe que o valor será 0 se não houver mais itens a serem recuperados.

Retorna um valor de erro definido por COM caso contrário.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)