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

Статья
08/26/2023

Определяет, является ли указанная структура ITEMIDLIST дочерней по отношению к другой структуре ITEMIDLIST .

Синтаксис

PUIDLIST_RELATIVE ILFindChild(
  [in] PIDLIST_ABSOLUTE  pidlParent,
  [in] PCIDLIST_ABSOLUTE pidlChild
);

Параметры

[in] pidlParent

Тип: PCIDLIST_ABSOLUTE

Указатель на родительскую структуру ITEMIDLIST .

[in] pidlChild

Тип: PCIDLIST_ABSOLUTE

Указатель на дочернюю структуру ITEMIDLIST .

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

Тип: PUIDLIST_RELATIVE

Возвращает указатель на простую структуру ITEMIDLIST дочернего элемента, если pidlChild является дочерним элементом pidlParent. Возвращаемая структура состоит из pidlChild, за вычетом структур SHITEMID , составляющих pidlParent. Возвращает значение NULL , если pidlChild не является дочерним элементом pidlParent.

Примечание Возвращаемый указатель является указателем на существующую родительскую структуру. Это псевдоним для pidlChild. Новая память не выделяется в связи с возвращенным указателем. Освобождение возвращаемого значения не лежит на вызывающем объекте.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shlobj_core.h (включая Shlobj.h)
Библиотека	Shell32.lib
DLL	Shell32.dll (версия 5.0 или более поздняя)

Share via