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

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

  • Статья

Учитывая элемент пространства имен оболочки, указанный в виде папки, и список идентификаторов элементов относительно этой папки, эта функция привязывается к родительскому элементу пространства имен и при необходимости возвращает указатель на окончательный компонент списка идентификаторов элементов.

Синтаксис

SHSTDAPI SHBindToFolderIDListParent(
  [in, optional]  IShellFolder       *psfRoot,
  [in]            PCUIDLIST_RELATIVE pidl,
  [in]            REFIID             riid,
  [out]           void               **ppv,
  [out, optional] PCUITEMID_CHILD    *ppidlLast
);

Параметры

[in, optional] psfRoot

Тип: IShellFolder*

Указатель на объект папки оболочки. Если psfRoot имеет значение NULL, указывает, что переданный IDList относится к рабочему столу.

[in] pidl

Тип: PCUIDLIST_RELATIVE

PIDL для привязки относительно psfRoot. Если psfRoot имеет значение NULL, это абсолютный идентификатор IDList относительно папки рабочего стола.

[in] riid

Тип: REFIID

Ссылка на нужный идентификатор интерфейса. Обычно это IID_IShellFolder или IID_IShellFolder2, но может поддерживаться в целевой папке.

[out] ppv

Тип: void**

При возврате этой функции содержит указатель интерфейса, запрошенный в riid. Обычно это IShellFolder или IShellFolder2, но может быть любым, что поддерживается целевой папкой.

[out, optional] ppidlLast

Тип: PCUITEMID_CHILD*

Указатель на последний идентификатор параметра pidl и является дочерним идентификатором относительно родительской папки, возвращаемой в ppv. Это значение может иметь значение NULL.

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

Тип: HRESULT

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

Комментарии

Примечание Вызов функции SHBindToFolderIDListParent эквивалентен вызову функции SHBindToFolderIDListParentEx с null в качестве контекста привязки.
 

Требования

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

См. также раздел

SHBindToFolderIDListParentEx