Função SHBindToObject (shlobj_core.h)

Recupera e associa a um objeto especificado usando o método IShellFolder::BindToObject do namespace do Shell.

Sintaxe

SHSTDAPI SHBindToObject(
        IShellFolder       *psf,
        PCUIDLIST_RELATIVE pidl,
  [in]  IBindCtx           *pbc,
        REFIID             riid,
  [out] void               **ppv
);

Parâmetros

psf

Tipo: IShellFolder*

Um ponteiro para IShellFolder. Este parâmetro pode ser NULL. Se psf for NULL, isso indicará que o parâmetro pidl é relativo à área de trabalho. Nesse caso, pidl deve especificar um ITEMIDLIST absoluto.

pidl

Tipo: PCUIDLIST_RELATIVE

Um ponteiro para um ITEMIDLIST constante a ser associado a que é relativo ao psf. Se psf for NULL, este será um ITEMIDLIST absoluto em relação à pasta da área de trabalho.

[in] pbc

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. 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.

riid

Tipo: REFIID

Identificador da interface a ser retornada.

[out] ppv

Tipo: void**

Quando esse método retorna, contém o ponteiro de interface conforme especificado em riid para o objeto associado. Se ocorrer um erro, conterá um ponteiro 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 Essa é uma função auxiliar que obtém o objeto da área de trabalho chamando SHGetDesktopFolder.

 

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

Ishellfolder

IShellFolder::BindToObject