Функция SHCreateShellItemArray (shobjidl_core.h)

Статья
08/26/2023

Создает объект массива элементов оболочки.

Синтаксис

SHSTDAPI SHCreateShellItemArray(
  [in]  PCIDLIST_ABSOLUTE     pidlParent,
  [in]  IShellFolder          *psf,
  [in]  UINT                  cidl,
  [in]  PCUITEMID_CHILD_ARRAY ppidl,
  [out] IShellItemArray       **ppsiItemArray
);

Параметры

[in] pidlParent

Тип: PCIDLIST_ABSOLUTE

Список идентификаторов родительской папки элементов, указанных в ppidl. Если указан psf , этот параметр может иметь значение NULL. Если этот pidlParent не указан, он вычисляется из параметра psf с помощью IPersistFolder2.

[in] psf

Тип: IShellFolder*

Объект источника данных оболочки, который является родительским для дочерних элементов, указанных в ppidl. Если указан pidlParent , этот параметр может иметь значение NULL.

[in] cidl

Тип: UINT

Количество элементов в массиве, заданном ppidl.

[in] ppidl

Тип: PCUITEMID_CHILD_ARRAY

Список идентификаторов дочерних элементов, для которых создается массив. Это значение может иметь значение NULL.

[out] ppsiItemArray

Тип: IShellItemArray**

При возврате этой функции содержит адрес указателя интерфейса IShellItemArray .

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

Тип: HRESULT

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Требования

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

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