Método IEnumString::Next (objidlbase.h)

Artigo
03/05/2024

Recupera o número especificado de itens na sequência de enumeração.

Sintaxe

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

Parâmetros

[in] celt

O número de itens a serem recuperados. Se houver menos do que o número solicitado de itens restantes na sequência, esse método recuperará os elementos restantes.

[out] rgelt

Uma matriz de itens enumerados.

O enumerador é responsável por alocar qualquer memória e o chamador é responsável por liberá-la. Se celt for maior que 1, o chamador também deverá passar um ponteiro não NULL passado para pceltFetched para saber quantos ponteiros liberar.

[out] pceltFetched

O número de itens que foram recuperados. Esse parâmetro é sempre menor ou igual ao número de itens solicitados.

Retornar valor

Se o método recuperar o número de itens solicitados, o valor retornado será S_OK. Caso contrário, será S_FALSE.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	objidlbase.h (inclua ObjIdl.h)

Confira também

Ienumstring

Compartilhar via