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

Создает объект IShellItem .

Синтаксис

SHSTDAPI SHCreateShellItem(
  [in, optional] PCIDLIST_ABSOLUTE pidlParent,
  [in, optional] IShellFolder      *psfParent,
  [in]           PCUITEMID_CHILD   pidl,
  [out]          IShellItem        **ppsi
);

Параметры

[in, optional] pidlParent

Тип: PCIDLIST_ABSOLUTE

Значение PIDL для родительского объекта. Это значение может иметь значение NULL.

[in, optional] psfParent

Тип: IShellFolder*

Указатель на родительскую папку IShellFolder. Это значение может иметь значение NULL.

[in] pidl

Тип: PCUITEMID_CHILD

Значение PIDL для запрошенного элемента. Если родительская информация не включена в pidlParent или psfParent, это должен быть абсолютный идентификатор PIDL.

[out] ppsi

Тип: IShellItem**

При возврате этого метода содержит указатель интерфейса на новый элемент IShellItem.

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

Тип: HRESULT

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

Комментарии

SHCreateShellItem создает объект , представляющий элемент пространства имен оболочки. Вызывающий объект должен предоставлять родительские сведения в pidlParent или psfParent; Кроме того, вызывающий объект может предоставить абсолютный idList в параметре pidl .

Существует три допустимых шаблона вызова для этой функции:

1. Родительская папка определяется абсолютным идентификатором IDList pidlParent. Параметр pidl указывает на дочерний IDList, который идентифицирует элемент в папке, определяемой pidlParent.

   IShellItem *psi;
   SHCreateShellItem(pidlParent, NULL, pidlChild, &psi);
   
   

2. Родительскую папку определяет psfParent. Параметр pidl указывает на дочерний IDList, который идентифицирует элемент в папке, определяемой psfParent.

   IShellItem *psi;
   SHCreateShellItem(NULL, psfParent, pidlChild, &psi);
   
   

3. Элемент идентифицируется абсолютным идентификатором IDList, переданным параметру pidl .

   IShellItem *psi;
   SHCreateShellItem(NULL, NULL, pidlFull, &psi);
   
   

Требования