Функция 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 [только классические приложения]
Целевая платформа	Windows
Header	shlobj_core.h (включая Shlobj.h)
DLL	Shell32.dll

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

IShellFolder

IShellFolder::BindToObject