Compartir a través de

Función SHBindToObject (shlobj_core.h)

  • Artículo

Recupera y enlaza a un objeto especificado mediante el método IShellFolder::BindToObject del espacio de nombres shell.

Sintaxis

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

Parámetros

psf

Tipo: IShellFolder*

Puntero a IShellFolder. Este parámetro puede ser NULL. Si psf es NULL, esto indica que el parámetro pidl es relativo al escritorio. En este caso, pidl debe especificar un ITEMIDLIST absoluto.

pidl

Tipo: PCUIDLIST_RELATIVE

Puntero a una constante ITEMIDLIST a la que se va a enlazar con respecto a psf. Si psf es NULL, se trata de un ITEMIDLIST absoluto relativo a la carpeta de escritorio.

[in] pbc

Tipo: IBindCtx*

Puntero a la 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.

riid

Tipo: REFIID

Identificador de la interfaz que se va a devolver.

[out] ppv

Tipo: void**

Cuando este método vuelve, contiene el puntero de interfaz tal y como se especifica en riid para el objeto enlazado. Si se produce un error, contiene un puntero NULL .

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Nota Se trata de una función auxiliar que obtiene el objeto de escritorio mediante una llamada a SHGetDesktopFolder.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj_core.h (incluya Shlobj.h)
Archivo DLL Shell32.dll

Consulte también

IShellFolder

IShellFolder::BindToObject