Функция ILNext (shlobj_core.h)

Извлекает следующую структуру SHITEMID в структуре ITEMIDLIST .

Синтаксис

PCUIDLIST_RELATIVE ILNext(
  [in] PCUIDLIST_RELATIVE pidl
);

Параметры

[in] pidl

Тип: PCUIDLIST_RELATIVE

Константный относительный идентификатор PIDL, для которого извлекается следующая структура SHITEMID .

Возвращаемое значение

Тип: PCUIDLIST_RELATIVE

При возврате этой функции содержит один из трех результатов: если pidl является допустимым, а не последним SHITEMID в ITEMIDLIST, он содержит указатель на следующую структуру ITEMIDLIST . Если передается последняя структура ITEMIDLIST , она содержит значение NULL, которое сигнализирует о конце PIDL. Для других значений pidl возвращаемое значение не имеет смысла.

Комментарии

Для использования, где определен STRICT_TYPED_ITEMIDS.

Чтобы проверить, равно ли возвращаемое значение NULL, используйте ilIsEmpty.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	shlobj_core.h (включая Shlobj.h)