Метод IShellFolder::BindToStorage (shobjidl_core.h)

Запрашивает указатель на интерфейс хранилища объекта.

Синтаксис

HRESULT BindToStorage(
  [in]  PCUIDLIST_RELATIVE pidl,
  [in]  IBindCtx           *pbc,
  [in]  REFIID             riid,
  [out] void               **ppv
);

Параметры

[in] pidl

Тип: PCUIDLIST_RELATIVE

Адрес структуры ITEMIDLIST , которая идентифицирует вложенную папку относительно родительской папки. Структура должна содержать ровно одну структуру SHITEMID , за которой следует завершающий нуль.

[in] pbc

Тип: IBindCtx*

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

[in] riid

Тип: REFIID

Идентификатор IID запрошенного интерфейса хранилища. Чтобы получить указатель интерфейса IStream, IStorage или IPropertySetStorage , задайте для riidзначение IID_IStream, IID_IStorage или IID_IPropertySetStorage соответственно.

[out] ppv

Тип: void**

Адрес, получающий указатель интерфейса, указанный riid. При возникновении ошибки в этом адресе возвращается указатель NULL .

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

Тип: HRESULT

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

Комментарии

Расширения пространства имен позволяют приложениям выполнять привязку к объекту, представляющего хранилище элемента. Если этот параметр поддерживается, IShellFolder::BindToStorage возвращает указанный указатель интерфейса, который затем можно использовать для доступа к содержимому объекта . Дополнительные сведения см. в справочнике по IMoniker::BindToStorage .

Требования