Función SHBindToParent (shlobj_core.h)

Toma un puntero a una lista de identificadores de elementos completos (PIDL) y devuelve un puntero de interfaz especificado en el objeto primario.

Sintaxis

SHSTDAPI SHBindToParent(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [in]  REFIID            riid,
  [out] void              **ppv,
  [out] PCUITEMID_CHILD   *ppidlLast
);

Parámetros

[in] pidl

Tipo: PCIDLIST_ABSOLUTE

PIDL del elemento.

[in] riid

Tipo: REFIID

REFIID de una de las interfaces expuestas por el objeto primario del elemento.

[out] ppv

Tipo: VOID**

Puntero a la interfaz especificada por riid. Debe liberar el objeto cuando haya terminado.

[out] ppidlLast

Tipo: PCUITEMID_CHILD*

PIDL del elemento en relación con la carpeta primaria. Este PIDL se puede usar con muchos de los métodos admitidos por las interfaces de la carpeta primaria. Si establece ppidlLast en NULL, el PIDL no se devuelve.

NotaSHBindToParent no asigna un nuevo PIDL; simplemente recibe un puntero a través de este parámetro. Por lo tanto, no es responsable de liberar este recurso.

 

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 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlobj_core.h (incluya Shlobj.h)
Library	Shell32.lib
Archivo DLL	Shell32.dll (versión 5.0 o posterior)