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

Извлекает и привязывается к указанному объекту с помощью метода IShellFolder::BindToObject .

Синтаксис

SHSTDAPI SHBindToObject(
        IShellFolder       *psf,
        PCUIDLIST_RELATIVE pidl,
  [in]  IBindCtx           *pbc,
        REFIID             riid,
  [out] void               **ppv
);

Параметры

psf

Тип: IShellFolder*

Указатель на IShellFolder. Этот параметр может иметь значение NULL. Если psf имеет значение NULL, это означает, что pidl параметра относится к рабочему столу. В этом случае pidl должен указать абсолютный ITEMIDLIST.

pidl

Тип: PCUIDLIST_RELATIVE

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

[in] pbc

Тип: IBindCtx*

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

riid

Тип: REFIID

Идентификатор возвращаемого интерфейса.

[out] ppv

Тип: void**

Когда этот метод возвращается, содержит указатель интерфейса, указанный в riid для привязанного объекта. Если возникает ошибка, содержит указатель NULL .

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

Тип: HRESULT

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

Замечания

Заметка Это вспомогательной функции, которая получает классический объект путем вызова SHGetDesktopFolder.

 

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 [только классические приложения]
целевая платформа	Виндоус
Header	shlobj_core.h (include Shlobj.h)
Library	OneCore.Lib
DLL	Shell32.dll

См. также

IShellFolder

IShellFolder::BindToObject