Función SHBindToFolderIDListParentEx (shlobj_core.h)
Extiende la función SHBindToFolderIDListParent al permitir que el autor de la llamada especifique un contexto de enlace.
Sintaxis
SHSTDAPI SHBindToFolderIDListParentEx(
[in, optional] IShellFolder *psfRoot,
[in] PCUIDLIST_RELATIVE pidl,
[in, optional] IBindCtx *ppbc,
[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, optional] ppbc
Tipo: IBindCtx*
Puntero a la interfaz IBindCtx en un objeto de contexto de enlace que se va a usar durante esta operación. Si no se usa este parámetro, establézcalo en NULL, que equivale a llamar a la función SHBindToFolderIDListParent . 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
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.
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 |