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

Статья
03/05/2024

Расширяет функцию 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*

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

[in] pidl

Тип: PCUIDLIST_RELATIVE

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

[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 .

Требования

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

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

SHBindToFolderIDListParent

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