Método IShellFolder::BindToStorage (shobjidl_core.h)

Solicita un puntero a la interfaz de almacenamiento de un objeto.

Sintaxis

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

Parámetros

[in] pidl

Tipo: PCUIDLIST_RELATIVE

Dirección de una estructura ITEMIDLIST que identifica la subcarpeta relativa a su carpeta primaria. La estructura debe contener exactamente una estructura SHITEMID seguida de un cero de terminación.

[in] pbc

Tipo: IBindCtx*

La dirección opcional de una interfaz IBindCtx en un objeto de contexto de enlace que se usará durante esta operación. Si no se usa este parámetro, establézcalo en NULL. Dado que la compatibilidad con pbc es opcional para las implementaciones de objetos de carpeta, es posible que algunas carpetas no admitan el uso de contextos de enlace.

[in] riid

Tipo: REFIID

IiD de la interfaz de almacenamiento solicitada. Para recuperar un puntero de interfaz IStream, IStorage o IPropertySetStorage , establezca riiden IID_IStream, IID_IStorage o IID_IPropertySetStorage, respectivamente.

[out] ppv

Tipo: void**

Dirección que recibe el puntero de interfaz especificado por riid. Si se produce un error, se devuelve un puntero NULL en esta dirección.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Las extensiones de espacio de nombres tienen la opción de permitir que las aplicaciones se enlacen a un objeto que representa el almacenamiento de un elemento. Si se admite esta opción, IShellFolder::BindToStorage devuelve un puntero de interfaz especificado que se puede usar para tener acceso al contenido del objeto. Consulte la referencia de IMoniker::BindToStorage para obtener más información.

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (include Shobjidl.h)
Archivo DLL	Shell32.dll (versión 4.0 o posterior)