Compartir a través de

Función SHBindToFolderIDListParent (shlobj_core.h)

  • Artículo

Dado un elemento de espacio de nombres de Shell especificado en forma de carpeta y una lista de identificadores de elemento relativa a esa carpeta, esta función se enlaza al elemento primario del elemento de espacio de nombres y, opcionalmente, devuelve un puntero al componente final de la lista de identificadores de elemento.

Sintaxis

SHSTDAPI SHBindToFolderIDListParent(
  [in, optional]  IShellFolder       *psfRoot,
  [in]            PCUIDLIST_RELATIVE pidl,
  [in]            REFIID             riid,
  [out]           void               **ppv,
  [out, optional] PCUITEMID_CHILD    *ppidlLast
);

Parámetros

[in, optional] psfRoot

Tipo: IShellFolder*

Puntero a un objeto de carpeta shell. Si psfRoot es NULL, indica que idList pasado es relativo al escritorio.

[in] pidl

Tipo: PCUIDLIST_RELATIVE

PIDL al que se va a enlazar, en relación con psfRoot. Si psfRoot es NULL, se trata de un IDList absoluto en relación con la carpeta de escritorio.

[in] riid

Tipo: REFIID

Referencia al identificador de interfaz deseado. Esto suele ser IID_IShellFolder o IID_IShellFolder2, pero puede ser cualquier cosa compatible con la carpeta de destino.

[out] ppv

Tipo: void**

Cuando se devuelve esta función, contiene el puntero de interfaz solicitado en riid. Esto suele ser IShellFolder o IShellFolder2, pero puede ser cualquier cosa compatible con la carpeta de destino.

[out, optional] ppidlLast

Tipo: PCUITEMID_CHILD*

Puntero al último identificador del parámetro pidl y es un identificador secundario relativo a la carpeta primaria devuelta en ppv. Este valor puede ser 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 Llamar a la función SHBindToFolderIDListParent equivale a llamar a la función SHBindToFolderIDListParentEx con NULL como contexto de enlace.
 

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

SHBindToFolderIDListParentEx