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

Принимает указатель на полный список идентификаторов элементов (PIDL) и возвращает указанный указатель интерфейса на родительский объект.

Синтаксис

SHSTDAPI SHBindToParent(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [in]  REFIID            riid,
  [out] void              **ppv,
  [out] PCUITEMID_CHILD   *ppidlLast
);

Параметры

[in] pidl

Тип: PCIDLIST_ABSOLUTE

PIDL элемента.

[in] riid

Тип: REFIID

REFIID одного из интерфейсов, предоставляемых родительским объектом элемента.

[out] ppv

Тип: VOID**

Указатель на интерфейс, заданный riid. По завершении необходимо освободить объект .

[out] ppidlLast

Тип: PCUITEMID_CHILD*

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

Примечание. SHBindToParent не выделяет новый PIDL. он просто получает указатель через этот параметр. Таким образом, вы не несете ответственности за освобождение этого ресурса.

 

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

Тип: HRESULT

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shlobj_core.h (включая Shlobj.h)
Библиотека	Shell32.lib
DLL	Shell32.dll (версия 5.0 или более поздняя)