Função SHBindToFolderIDListParentEx (shlobj_core.h)

Artigo
03/05/2024

Estende a função SHBindToFolderIDListParent permitindo que o chamador especifique um contexto de associação.

Sintaxe

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*

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, optional] ppbc

Tipo: IBindCtx*

Um ponteiro para a interface IBindCtx em um objeto de contexto de associação a ser usado durante essa operação. Se esse parâmetro não for usado, defina-o como NULL, o que equivale a chamar a função SHBindToFolderIDListParent . Como o suporte para pbc é opcional para implementações de objeto de pasta, algumas pastas podem não dar suporte ao uso de contextos de associação.

[in] riid

Tipo: REFIID

Referência à ID da 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 relativa à 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.

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

SHBindToFolderIDListParent

Compartilhar via