Share via

Função SHBindToFolderIDListParent (shlobj_core.h)

  • Artigo

Dado um item de namespace shell especificado na forma de uma pasta e uma lista de identificadores de item em relação a essa pasta, essa função se associa ao pai do item de namespace e, opcionalmente, retorna um ponteiro para o componente final da lista de identificadores de item.

Sintaxe

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*

Um ponteiro para um objeto de pasta shell. Se psfRoot for NULL, indicará que a IDList passada é relativa à área de trabalho.

[in] pidl

Tipo: PCUIDLIST_RELATIVE

Um PIDL ao qual associar, em relação a psfRoot. Se psfRoot for NULL, essa será uma IDList absoluta em relação à pasta da área de trabalho.

[in] riid

Tipo: REFIID

Referência à ID de interface desejada. Normalmente, isso é IID_IShellFolder ou IID_IShellFolder2, mas pode ser qualquer coisa compatível com a pasta de destino.

[out] ppv

Tipo: void**

Quando essa função retorna, contém o ponteiro de interface solicitado em riid. Normalmente, isso é IShellFolder ou IShellFolder2, mas pode ser qualquer coisa compatível com a pasta de destino.

[out, optional] ppidlLast

Tipo: PCUITEMID_CHILD*

Um ponteiro para a última ID do parâmetro pidl e é uma ID filho em relação à pasta pai retornada em ppv. Esse valor pode ser NULL.

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.

Comentários

Nota Chamar a função SHBindToFolderIDListParent é equivalente a chamar a função SHBindToFolderIDListParentEx com NULL como o contexto de associação.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj_core.h (inclua Shlobj.h)
DLL Shell32.dll

Confira também

SHBindToFolderIDListParentEx