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.

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