Función SHBindToFolderIDListParent (shlobj_core.h)

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

Requisitos

Consulte también

SHBindToFolderIDListParentEx