Função ILNext (shlobj_core.h)

Recupera a próxima estrutura SHITEMID em uma estrutura ITEMIDLIST .

Sintaxe

PCUIDLIST_RELATIVE ILNext(
  [in] PCUIDLIST_RELATIVE pidl
);

Parâmetros

[in] pidl

Tipo: PCUIDLIST_RELATIVE

Um PIDL constante, não atribuído e relativo para o qual a próxima estrutura SHITEMID está sendo recuperada.

Retornar valor

Tipo: PCUIDLIST_RELATIVE

Quando essa função retorna, contém um dos três resultados: se pidl for válido e não o último SHITEMID no ITEMIDLIST, ele conterá um ponteiro para a próxima estrutura ITEMIDLIST . Se a última estrutura ITEMIDLIST for passada, ela conterá NULL, o que sinalizará o fim do PIDL. Para outros valores de pidl, o valor retornado não tem sentido.

Comentários

Para uso em que STRICT_TYPED_ITEMIDS é definido.

Para verificar se o valor retornado é NULL, use ILIsEmpty.

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	shlobj_core.h (inclua Shlobj.h)