Função SHBindToParent (shlobj_core.h)

Usa um ponteiro para uma lista de identificadores de itens totalmente qualificados (PIDL) e retorna um ponteiro de interface especificado no objeto pai.

Sintaxe

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

Parâmetros

[in] pidl

Tipo: PCIDLIST_ABSOLUTE

O PIDL do item.

[in] riid

Tipo: REFIID

A REFIID de uma das interfaces expostas pelo objeto pai do item.

[out] ppv

Tipo: VOID**

Um ponteiro para a interface especificada por riid. Você deve liberar o objeto quando terminar.

[out] ppidlLast

Tipo: PCUITEMID_CHILD*

O PIDL do item em relação à pasta pai. Esse PIDL pode ser usado com muitos dos métodos compatíveis com as interfaces da pasta pai. Se você definir ppidlLast como NULL, o PIDL não será retornado.

ObservaçãoSHBindToParent não aloca um novo PIDL; ele simplesmente recebe um ponteiro por meio desse parâmetro. Portanto, você não é responsável por liberar esse recurso.

 

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlobj_core.h (inclua Shlobj.h)
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 5.0 ou posterior)