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

Расширяет функцию SHBindToFolderIDListParent , позволяя вызывающему объекту указать контекст привязки.

Синтаксис

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

Параметры

[in, optional] psfRoot

Тип: IShellFolder*

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

[in] pidl

Тип: PCUIDLIST_RELATIVE

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

[in, optional] ppbc

Тип: IBindCtx*

Указатель на интерфейс IBindCtx для объекта контекста привязки, который будет использоваться во время этой операции. Если этот параметр не используется, задайте для него значение NULL, что эквивалентно вызову функции SHBindToFolderIDListParent . Так как поддержка PBC является необязательной для реализации объектов папок, некоторые папки могут не поддерживать использование контекстов привязки.

[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