Поделиться через

Функция 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)